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Preface 





Document Structure 


This book describes how to use the VAX DOCUMENT global tags. 
Global tags are SDML tags that you can use in any doctype, with a 
few exceptions. VAX DOCUMENT Using Doctypes and Related Tags 
describes the rest of the VAX DOCUMENT tags: the doctype-specific 
tags. Doctype-specific tags are tags restricted for use in certain doctypes. 


For example, the <LIST> tag is a global tag that you can use in any doctype. 
The <SALUTATION> tag, however, is. a doctype-specific tag that you can use 
only in the LETTER doctype. 


¢ Chapter 1 provides a description of all global tags. 
e Appendix A is a summary of the VAX DOCUMENT commands. 


¢ Appendix B lists and explains the messages you see when processing 
source files. 


Intended Audience 


This book is intended for writers, editors, and general users who wish to 
produce technical manuals, brochures, business letters, overhead slides, 

or online documentation using VAX DOCUMENT. Familiarity with a text 
editor is presumed, as is a basic knowledge of the VMS operating system. 





Associated Documents 


This manual is part of the VAX DOCUMENT documentation set that 
includes the following books: 


¢ VAX DOCUMENT Producing Online and Printed Documentation 
¢ VAX DOCUMENT Using Doctypes and Related Tags 

¢ VAX DOCUMENT Designing Doctypes 

¢ VAX DOCUMENT Tags Quick Reference 

¢ VAX DOCUMENT Quick Reference Card 

e VAX DOCUMENT Graphics Editor User’s Guide 

¢ VAX DOCUMENT Installation Guide 





Conventions 


Chapter 1 contains, in a fixed order, a discussion of each global tag. 
First, the name of the tag is followed by a brief overview that describes 
the purpose of the tag. Following the overview is a syntax section that 
displays the syntax of the tag: any required or optional arguments. 
Following the syntax section is an arguments section that describes any 
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Note: 


arguments, any related tags, any restrictions on the use of the tag, and 
any required terminating tags. 


The related tags, restrictions, and required terminator sections 
are omitted if there is no relevant information. 


The category of “related tag” is defined broadly. A tag is related to the tag 
under discussion if one of the following criteria is met: 


¢ Itis required for use of the tag under discussion. 
¢ It marks a text element of the same kind as the tag under discussion. 
¢ It is commonly used with the tag under discussion. 


e Itis a tag with a similar function to the tag under discussion. 


Next is a description section. The description expands the overview and 
presents more detailed information on using the tag. 


The discussion of a tag concludes with an examples section, with at least 
one example or a reference to an example. The example shows how to code 
the tag in an SDML file, and, when possible, shows what the formatted 
result is when the file is processed for printing. 


Each output example is introduced by a form of the sentence, “This 
example produces the following output:”. The examples were processed 
using a local doctype based on one of the six SOFTWARE doctypes, 
SOFTWARE.REFERENCE. Your output of these examples may vary, 
however, depending on the doctype you use and on whether any 
doctype modifications have been made to your local installation of VAX 
DOCUMENT. | 


Table 1 lists the typographical conventions used in this manual. 


Table 1 Conventions Used in this Manual 


Convention 


Meaning 





TERM 


<TAG>(argument) 


<TAG>[(argument)] 


viii 


In examples, a vertical ellipsis represents the omission of 
data that the system displays in response to a command 
or to data you enter. 


In examples, a horizontal ellipsis indicates that you can 
enter additional parameters, values, or other information. 
In tag syntax, a horizontal ellipsis indicates that arguments 
to the tag have been omitted. 


A term that appears in bold type is defined in the glossary 


in the VAX DOCUMENT Producing Online and Printed 
Documentation. 


Parentheses enclose an argument to a tag. A lowercase 
word as an argument to a tag indicates that a user- 
specified argument must be entered. 


Brackets indicate that the enclosed argument to the tag is 
optional. 
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Table 1 (Cont.) Conventions Used in this Manual 


Convention 


<TAG>[(argument-1 [ \argument-2])] 


<TAG>[([argument-1] \ [argument-2])] 


<TAG> [( { argument-1 In 


KEYWORD-1 [ \KEYWORD-2] 


~ 


<TAG>(KEYWORD) 


<TAG>(\KEYWORD) 


\ 


Meaning _ 


This tag syntax indicates that both arguments are optional. 
Only if you use argument-1, however, do you have the 
choice of using argument-2. 


This tag syntax indicates that both arguments are optional. 
You can use either argument as the first argument. 


This tag syntax indicates that all arguments are optional. 
The braces indicate a choice between argument-1 and 
KEYWORD-1. You must choose your first argument. If 
you choose KEYWORD-1, you also have the option of 
indicating KEYWORD-2 as the second argument. 


An uppercase word within an argument to a tag indicates 
that the word is a keyword, and that you must enter the 
specific keyword. 


A keyword following a backslash in an argument to a tag 
indicates that that keyword must follow a backslash. 


A backslash separates multiple arguments to a tag. © 


New Features 


The following list contains the new features of VAX DOCUMENT 
Version 2.0: 


The considerations for Bookreader output, if different from printed 
output, are noted for each affected tag. 


The <LANGUAGE> tag is a new tag for creating documentation in 
several languages. 


A new argument exists for the /DEVICE_CONVERTER qualifier on 
the DOCUMENT command line: /DEVICE_CONVERTER=DUPLEX. 
This argument creates a two-sided POSTSCRIPT document for printing 
on a duplex printer or for copying on a two-sided copier. 


Monospaced fonts defined for all the sizes are provided for text fonts in 
the POSTSCRIPT destination. 


The new attributes, BOTH and NOMASTER, exist for indexing with 
the <x> tag. BOTH specifies an index entry that you want to appear 
in both a single-document and master index. NOMASTER specifies an 
index entry that you want to appear only in a single-document index 
and not in a master index. 


You can refer to headings in your preface from other parts of your 
document. The headings in a preface, however, do not have numbers 
and do not appear in the table of contents. 


The documentation set has been extensively revised. A list of the major 
changes in this manual follows: 


An improved index. 
More and improved examples for each tag. 
A clearer description of each tag. 


A glossary of terms exists in VAX DOCUMENT Producing Online and 
Printed Documentation. 


The first eight chapters of the VAX DOCUMENT User Manual, 
Volume 1, Version 1.1 is now condensed and part of VAX DOCUMENT 
Producing Online and Printed Documentation. 
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1 Global Tag Descriptions 


This chapter provides descriptions of all global tags. The tags are listed 
alphabetically. Terminating tags, which are tags that you must use to 
terminate a tag (such as <LIST> and its terminating tag <ENDLIST>), are not 
listed separately, except when the terminating tag has an argument. Each 
terminating tag is listed in the description of the tag it terminates. You 
can also find terminating tags listed in the index. 


<ABSTRACT> 


<ABSTRACT> 


Begins a summary description of a document on the title page or part page of 
the document. 





SYNTAX <ABSTRACT>/(heading)] 





ARGUMENTS heading 


Specifies a heading for the abstract. 





related tags e <FRONT._MATTER> 
° <PART_PAGE> 
@ <TITLE_PAGE> 








restrictions Valid only in the context of a <TITLE_PAGE> or <PART_PAGE> tag. 
required <ENDABSTRACT> 
terminator 


DESCRIPTION _ The <ABSTRACT> tag begins a summary description of a document on the 
title page or part page of the document. A part page is a dividing page 
between major sections of a document. 


EXAMPLE See the example in the discussion of the <PART> tag. 


ooh, 


—2 


<ACCENT> 


<ACCENT> 


Supplies a freestanding acute, grave, or umlaut accent mark. 


SYNTAX ACUTE 
<ACCENT>(? GRAVE }) 


UMLAUT 








ARGUMENTS ACUTE 
GRAVE 


UMLAUT 


Specifies one of these keywords to indicate the type of accent mark. 





related tags ° <MCS> 
¢ <PARENDCHAR> 





restrictions ’ Invalid in math. 





DESCRIPTION _ The <ACCENT> tag supplies a freestanding acute, grave, or umlaut accent 
mark. This tag has no effect for Bookreader output. 





EXAMPLE The following example shows how to use the <ACCENT> tag. The 
<PARENDCHAR> tag in this example simply provides better spacing of 
the accent characters within the parentheses. See the <PARENDCHAR> tag 
description for more information. 


<P>Accents used in the Digital Multinational Character Set include the 
following: 

<LIST> (UNNUMBERED) 

<LE>Acute accents <PARENDCHAR> (<ACCENT> (ACUTE) ) 

<LE>Grave accents <PARENDCHAR> (<ACCENT> (GRAVE) ) 

<LE>Umlauts <PARENDCHAR> (<ACCENT> (UMLAUT) ) 

<ENDLIST> 


This example produces the following output: 


Accents used in the DEC Multinational Character Set include the 
following: 


e Grave accents (~) 
e Acute accents (°) 


¢ Unmlauts (") 


<ALIGN_AFTER> 


<ALIGN AFTER> 


Allows you to position text in a list after the text specified in the argument. 





SYNTAX <ALIGN_AFTER> (text) 





ARGUMENTS _ text 


Specifies the string of text after which you want to align the text that 








follows. 
related tags ° <ALIGN_NUMBER> 
° <ALIGN_CHAR> | 
¢  <LINE>(INDENT) 
° <LIST>(STACKED) 
restrictions Invalid in math. 


DESCRIPTION _ The <ALIGN_AFTER> tag allows you to position text in a list after the text 
specified in the argument. 





EXAMPLE The following example shows how to create a stacked list where the text is 
aligned after the string “UN.” 


<LIST> (STACKED\BRACES) : 
<LE><ALIGN_AFTER> (UN) ALPHABETICAL 
<LE>UNNUMBERED 

<ENDLIST> 


This example produces the following output: 


{ ALPHABETICAL } 
UNNUMBERED 


<ALIGN_CHAR> 


<ALIGN_CHAR> 


Identifies a nonprinting character you want to use to align numeric information 
in text or within a column of a list or table. 





SYNTAX 


<ALIGN_CHAR>(character [\ DELTA]) 





ARGUMENTS 


related tags 


restrictions 


required — 
terminator 


character | | 
Specifies the character to be used for alignment. The character must be 
one of the following special characters: 


{ } ‘* # § 


% * ~ @ 
[ 1 « 4 
DELTA 


This is an optional keyword argument. It specifies that the character 
indicated for alignment be replaced in your output with a delta character 
to indicate spacing. 





© <ALIGN AFTER> 
°  <ALIGN_NUMBER> 
e 6<TABLE_ROW> 





Invalid in math, in any major section tag (such as <CHAPTER>, <APPENDIX>, 
<SECTION>, and <COMMAND_SECTION>), and in any heading tag (such as 
<HEADI>, <SUBHEAD1>, and <CHEAD>). 


Do not nest an <ALIGN_CHAR> tag in another <ALIGN_CHAR> tag. 


Invalid in monospaced examples. Aligned characters can be referenced in 
an example, but you must place the <ALIGN_CHAR> and <ENDALIGN_CHAR> 
tags outside the example. 





<ENDALIGN_CHAR> 


DESCRIPTION 


The <ALIGN_CHAR> tag identifies a nonprinting character you want to use 
to align numeric information in text or within a column of a list or table. 
This character signifies a space, so that the tag translator replaces each 
occurrence of the character with a space. The space is the same width as 
the numeric characters in the font that is active. (All numeric characters 
of a font have a uniform width.) 


<ALIGN_CHAR> 


Items in a column are aligned on the left by default. You may want to 
display a column of numbers aligned on the right, however. If so, use the 
<ALIGN_CHAR> tag to define “#,” for example, as the alignment character. 
You make all the numeric entries an equal length by prefixing the shorter 
entries with the alignment character. Because the numeric characters are 
of uniform width, they will then align on the right. 


You can also use the alignment character to add space within the number. 
For example, you could separate the digits of a number at the thousands 





position. 
EXAMPLES The following example defines the number sign as the alignment character 
in a table. 
<ALIGN_CHAR> (#) 
<TABLE> 
<TABLE_SETUP> (2\16) 
<TABLE _ROW> (0#123#456#781\01234567.89) 
<TABLE _ROW> (#######35#279\###4#4#6 0) 
<TABLE ROW> (####¢¢##44341\###1429.857) 
<ENDTABLE> 
<ENDALIGN_CHAR> 
This example produces the following output: 
0 123 456 781 01234567.89 
35 279 6.0 
4 341 1429.857 
The following example shows the table used in the previous example 
without using the alignment character. 
2 <TABLE> 
<TABLE_SETUP> (2\16) 
<TABLE_ROW> (0123456789\01234567.89) 
<TABLE _ROW> (35279\6.0) 
<TABLE _ROW> (4361\1429.857) 
<ENDTABLE> 
This example produces the following output: 
0123456789 01234567.89 
35279 6.0 
4361 1429.857 
The following example defines the number sign as the alignment character 
in a list. 
<ALIGN_CHAR> (#) 


<LIST> (numbered) | 
<LE> (0#1234#456#781) 
<LE> (####444 354279) 
<LE> (####EHHHEA E341) 
<ENDLIST> 
<ENDALIGN_CHAR> 


This example produces the following output: 


<LIST> (numbered) 
<LE>0123456781 
<LE>35279 
<LE>4341 
<ENDLIST> 


<ALIGN_CHAR> 


1 0123 456 781 
2 35 279 
3 4 361 


The following example shows the list used in the previous example without 
using the alignment character. 


This example produces the following output: 
1 0123456781 

2 35279 

3 4341 


The following example shows how you can represent blank output 
characters in text. The <KEEP> tag ensures that the text specified in its 
argument will not be broken across lines. See the <KEEP> tag description 
for more information. 


<P>The sum may be padded on the left with blanks, resulting in 


<ALIGN_CHAR> (#) 


<KEEP> (<SINGLE_QUOTE>###7 .56<SINGLE QUOTE>) 


<ENDALIGN_CHAR> 


This example produces the following output: 
The sum may be padded on the left with blanks, resulting in ’ 7.56’ 


The following example shows how you can represent delta output 
characters in text. 


<P>The sum may be padded on the left with delta characters, resulting in 
<ALIGN_CHAR> (#\DELTA) 
<KEEP> (<SINGLE_QUOTE>###7.56<SINGLE_QUOTE>) 


<ENDALIGN_CHAR> 


This example produces the following output: 


The sum may be padded on the left with delta characters, resulting in 
’ AAAT.56" 
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<ALIGN_NUMBER> 


<ALIGN_NUMBER> 


Specifies a number that you want to be aligned with other numbers in the 
same column of a table. 





SYNTAX 


<ALIGN_NUMBER> (number) 





ARGUMENTS 


related tags 


restrictions 


number 

Specifies a number, which can include commas and decimal points, that 
is to be aligned with other numbers in the same column. Fields in the 
number that are to be left blank may contain pound sign (#) characters 
representing blank numbers or semicolon (;) characters representing 
commas or decimal points. 





e¢ = =<ALIGN_AFTER> 
e <ALIGN_CHAR> 
¢ <TABLE_ROW> 





Invalid in the context of a <MATH> tag. 


DESCRIPTION 


The <ALIGN_NUMBER> tag specifies a number that you want to be aligned 
with other numbers in the same column of a table. Items in table columns 
are aligned on the left by default. To display a column of numbers aligned 
on the right or aligned around the decimal point, use the <ALIGN_NUMBER> 
tag. Use the pound sign and semicolon characters to represent fields in 
the number that are to be blank in your output. 


EXAMPLES 


| — | 


om, 


<table setup>(2\8) 

row> (one\<align_number> (100,000,000. ##) ) 
<table_row>(one\<align_number> (###; ###;240.40) ) 
<table_row>(one\<align_number> (###; ###7 ###. 60) ) 
<table row>(one\<align_number> (###;230, 425) ) 


The following example shows a series of numbers aligned at the decimal 
point. 


This example produces the following output: 


<ALIGN_NUMBER> 


one 100,000,000. 
one 240.40 
one .60 
one 230,425 


The following example is visually more elaborate, although the series of 
numbers are again aligned at the decimal point. 


<table> 

<table_setup>(3\15\10) 

<table heads>(Item\Net Revenue\Percentage) 
<table_row>(Knives\<align_number> (#; #20; 435; ##) \<align_number> (%#10.44) ) 
<table_row>(Forks\<align_number> (1, 432,064.23) \<align_number> (%#45.0#) ) 
<table_row>(Spoons\<align_number> (#; ###;245;##) \<align_number> (S###. 86) ) 
<endtable> 


This example produces the following output: 


Item Net Revenue Percentage 
Knives 20,435 % 10.44 
Forks 1,432,064.23 % 45.0 
Spoons 245 % 86 





<AMPERSAND> 


<AMPERSAND> 


Specifies an ampersand (&) anywhere in your file. To specify an ampersand 
in an argument to a tag or in the context of the <MATH> tag, you must use this 
tag. 





SYNTAX 


<AMPERSAND> 





ARGUMENTS 


related tags 


restrictions 


None. 





e The following tags label other characters that you must tag when they 
occur in an argument to a tag: 


<BACKSLASH> 

<CPAREN>—required only if there is no opening parenthesis 
<OPAREN>—required only if there is no closing parenthesis 
<VBAR> 





You must use the <AMPERSAND> tag to specify an ampersand in an 
argument to a tag or in the context of the <MATH> tag. 


DESCRIPTION 


The <AMPERSAND> tag specifies an ampersand (&) anywhere in your file. 
Because the ampersand has a special meaning to the tag translator when 
it occurs within an argument to a tag, you must use the <AMPERSAND> tag 
to output an ampersand within an argument to a tag or in the context of 
the <MATH> tag, or it may be misinterpreted by the tag translator. Outside 
of an argument to a tag, use the ampersand keyboard character rather 
than the tag. 


EXAMPLE 


The following example shows how to use the <AMPERSAND> tag. 


<SUBHEAD1>(Continuing the Line with <AMPERSAND>\cont_ampersand) 
<P>Your BASIC statement may be formatted over two or more lines 
by terminating all lines except the last with an ampersand (&). 
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This example produces the following output: 


Continuing the Line with & 


Your BASIC statement may be formatted over two or more lines by 
terminating all lines except the last with an ampersand (&). 


<APPENDIX> 


<APPENDIX> 


Begins an appendix. 








SYNTAX <APPENDIX> (appendix title[ \ symbol name]) 
ARGUMENTS ~— appendix title 

Specifies the title for the appendix. 

symbol name 


related tags 


restrictions 


required 
terminator 


This is an optional argument. It specifies the symbol name used in all 
cross-references to this appendix. The value of the symbol name in the 
cross-reference file is the letter assigned to the appendix. 


If the appendix is part of a book, the appendix letter is determined by the 
position of the appendix with respect to other appendixes in the book. 


If the file being processed is not currently part of a book, the first appendix 
in the source file is lettered A, and subsequent appendixes are sequentially 
lettered. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





¢ =6©<SET_APPENDIX_LETTER> 





If you include the file containing this tag in a bookbuild, you must provide 
a symbol name. 





<ENDAPPENDIX> 


DESCRIPTION 


The <APPENDIX> tag begins an appendix. An appendix contains 
supplementary material at the end of a book and can contain any number 
of other tags. 


DOCUMENT considers each appendix to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 
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<APPENDIX> 





EXAMPLE The following example shows how to code an appendix. 


<APPENDIX> (<REFERENCE> (product_name) Command Summary \ command_app) 


<ENDAPPENDIX> 


See Appendix A in this manual for a sample appendix. 
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<BACKSLASH> 


‘ 


<BACKSLASH 


Specifies a backslash anywhere in your file. To specify a backslash in an 
argument to a tag, you must use this tag. 








SYNTAX <BACKSLASH> 





ARGUMENTS _ Nore. 





related tags ¢ The following tags label other characters that you must tag when they 
, occur in an argument to a tag: 


<AMPERSAND> 

<CPAREN>—required only if there is no opening parenthesis 
<OPAREN>—required only if there is no closing parenthesis 
<VBAR> 





restrictions You must use the <BACKSLASH> tag to specify a backslash in an argument 
to a tag. 





DESCRIPTION _ The <BACKSLASH> tag specifies a backslash anywhere in your file. Because 
the literal backslash character is used to separate the arguments in the 
argument list to a tag, you must use the <BACKSLASH> tag to include a 
backslash as part of your argument. Outside of an argument to a tag, use. 
the backslash keyboard character rather than the tag. 





EXAMPLE The following example shows how to use the <BACKSLASH> tag. 
<SUBHEAD1>(Using the Backslash (<BACKSLASH>) \using_backslash) 
<P>Use the backslash character (\) to separate BASIC statements 


on the same line. 


This example produces the following output: 


Using the Backslash (\) 


Use the backslash character (\) to separate BASIC statements on the 
same line. 
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<BOX> 


<BOX> 


Produces a box that surrounds a user-specified character string. 





SYNTAX <BOX3 (label) 





ARGUMENTS __/abel 


Specifies the character string to be surrounded by the box. 





restrictions Invalid in the context of a <MATH> tag. 


The character string can be as many as 15 characters long. The box format 
is not available for all output devices. 





DESCRIPTION _ The <BOxX> tag produces a box that surrounds a user-specified character 
string. The case of the text is output as you entered it. The font, however, 
that the <BOX> tag uses distinguishes the enclosed text from the rest of the 
text. 





EXAMPLE The following example shows how to use the <BOX> tag. 


<P>You may need to enclose some text in a box, <BOX>(like this). 


This example produces the following output: 
You may need to enclose some text in a box, [like this]. 
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<CALLOUT> 


<CALLOUT> 


Identifies a number that is printed as a white letter in a black box or circle 
(depending on the output device) in an example. (The <CALLOUT> tag is 
identical to the <CO> tag.) 


SYNTAX <CALLOUT>/(number)] 








ARGUMENTS number 
This is an optional argument. It specifies the number of the callout. If you 
do not specify a callout number, the callouts are numbered sequentially. 








related tags ° <CALLOUT_REF> 
e¢ <CALLOUTS> 
e <CO> 
e <LIST>(CALLOUT) 

restrictions Valid only in the context of a <CALLOUTS> tag. 





DESCRIPTION The <CALLOUT> tag identifies a number that is printed as a white letter in 
a black box or circle (depending on the output device) in an example. 





EXAMPLES See the examples in the discussion of the <CALLOUTS> tag. 
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<CALLOUT_REF> 


<CALLOUT_ REF> 


Labels a reference in text to a callout number. 





SYNTAX <CALLOUT_REF>(callout number) 





ARGUMENTS ~ callout number 


Specifies the number in the callout. 





related tags * <CALLOUT> 
<CALLOUTS> 


<CO> 
¢ The following tags label other types of references: 


<REFERENCE>(symbol name) 
<GREF>(glossary term) 





restrictions Invalid in the context of a <MATH> and an <EXAMPLE> tag. 


DESCRIPTION _ The <CALLOUT_REF> tag labels a reference in text to a callout number. You 
create the callout number by using the <CALLOUT> tag in an example or 
figure. 


EXAMPLE The following example shows how to use the <CALLOUT_REF> tag. 
<P>In <REFERENCE> (page transitions fig), 
callout <CALLOUT_REF> (1) 


labels the beginning of the process. Callout <CALLOUT_REF>(2) labels the 
intermediate stage. 


This example produces the following output: 


In Figure 3-3, callout @ labels the beginning of the process. Callout @ 
labels the intermediate stage. 
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<CALLOUTS> 


<CALLOUTS> 


Labels the beginning of a series of callouts contained in an example and 
enables the use of the <CALLOUT> and <CO> tags. 





SYNTAX 


<CALLOUTS>/(/callout number] [\ PREFIX])] 





ARGUMENTS 


related tags 


restrictions 


required 
terminator 


callout number 

This is an optional argument. It sets the number that begins numbering 
the callouts. If you do not specify a number, the numbering begins with 
one. 


PREFIX 

This is an optional keyword argument. It specifies that the callouts appear 
before the line they label, rather than at the end of the line. All callouts 
in any one example must precede the line they label or appear inside or at 
the end of the line they label. You cannot mix the location of the callouts. 


This argument, if specified, must be the second argument, for example, 
<CALLOUTS>(\ PREFIX). 





¢ <CALLOUT> 

e =6©<CALLOUT_REF> 

°¢ <CO> 

* <LIST>(CALLOUT) 





The <CALLOUTS> and <ENDCALLOUTS> tags must surround the examples 
within which the callouts are used. 





<ENDCALLOUTS> 


DESCRIPTION 


The <CALLOUTS> tag labels the beginning of a series of callouts contained 
in an example and enables the use of the <CALLOUT> and <CO> tags. See 

the <LIST> tag description for information about how to label callouts in a 
list. 
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<CALLOUTS> 





EXAMPLES The following example shows how to use the <CALLOUTS> tag. 
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<CALLOUTS> 
<CODE_EXAMPLE> 
DO WHILE (“EOF); <CALLOUT> 

READ FILE(INFILE) INTO(Y); 
PUT LIST (Y); <CALLOUT> 
END; 

<ENDCODE _EXAMPLE> 

<ENDCALLOUTS> 

<LIST> (CALLOUT) 

<LE>This is a <KEYWORD>(DO) statement. 

<LE>This <KEYWORD>(PUT) statement outputs the line read. 

<ENDLIST> 


This example produces the following output: 


DO WHILE (“EOF); 1] 
READ FILE(INFILE) INTO(Y); 


PUT LIST(Y); 
END; 


@ This is a DO statement. 
© This PUT statement outputs the line read. 


The following example shows how you can set the number from which to 
begin numbering the callout sequence and how you can cause the callouts 
to precede the line to which they belong by using the PREFIX argument. 


<CALLOUTS> (3\PREFIX) 
<CODE_EXAMPLE> 
<CALLOUT> DO WHILE (*EOF); 
READ FILE(INFILE) INTO(Y); 


<CALLOUT> PUT LIST (Y); 
END; 
<ENDCODE_EXAMPLE> 
<ENDCALLOUTS> 
This example produces the following output: 
3 ] DO WHILE (*EOF); 
READ FILE(INFILE) INTO(Y); 
4) PUT LIST (Y); 
END; 
The following example shows how you can place callouts inside of lines 
and how you can use an argument to the <CALLOUT> tag to control the 
number of the callout. 
<CALLOUTS> 


<CODE_EXAMPLE> 
DO WHILE <CALLOUT>(9) (*EOF); 
READ FILE(INFILE) INTO(Y); 
PUT <CALLOUT>(12) LIST(Y); 
END; 
<ENDCODE_EXAMPLE> 
<ENDCALLOUTS> 


This example produces the following output: 


DO WHILE © (‘£0F); 
READ FILE(INFILE) INTO(Y); 
put @ uist(y); 
END; 


<CENTER_LINE> 


<CENTER LINE> 


Specifies a line of text you want to center in the current text margin. 





SYNTAX \BIGSKIP 
NTER 3 
SCE IEM Sen oel |SMALLSKIP | 2 


ARGUMENTS __ text 
Specifies a line of text you want to center. 
BIGSKIP 
SMALLSKIP 


These are optional keyword arguments. They specify a set amount of 
vertical space to precede the element identified as a line or block of text. 
The actual amount of space created is determined by the doctype. 








related tags ° <CHEAD> 
e 6 <LINE> 


¢ = <RIGHT_LINE> 





restrictions Invalid in monospaced examples, in the context of a <MATH> tag, and in 
arguments to tags that provide title or heading text. 


Centered text must fit within the current text margin. If you specify text 
that is too wide, the text formatter issues a warning message, and you 
should examine your output. 





DESCRIPTION _ The <CENTER_LINE> tag specifies a line of text you want to center in the 
current margin. 
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<CENTER_LINE> 





EXAMPLE The following example shows how to use both the BIGSKIP and 
SMALLSKIP keywords. 


<P>Please include the following information: 


<CENTER_LINE> (Name\smallskip) 
<CENTER_LINE> (Address \bigskip) 
<CENTER_LINE> (Phone Number) 


This example produces the following output: 
Please include the following information: 


Name 


Address 
Phone Number 
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<CHAPTER> 


<CHAPTER> 


Begins a chapter. 





SYNTAX <CHAPTER=> (chapter title [\ symbol name]) 





ARGUMENTS _~ chapter title 


Specifies the name of the chapter. The doctype may also use this argument 
in the running title. 


symbol name 

This is an optional argument. It specifies the symbol name used in all 
cross-references to this chapter. The value of the symbol name is the 
number assigned to the chapter. Each chapter is sequentially numbered. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





related tags * <REFERENCE> 
¢ <SET_CHAPTER_NUMBER> 





restrictions Invalid in the context of a <FRONT_MATTER> tag. 


If you include a file containing the <CHAPTER> tag in a bookbuild, including 
a bookbuild for Bookreader, you must provide a symbol name argument 
with the tag. 





DESCRIPTION The <CHAPTER> tag begins a chapter. When printed, the chapter title 
; and number are printed in a larger font. DOCUMENT automatically 
increments chapter numbers. 


DOCUMENT considers each chapter to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 





EXAMPLE The following example shows how to code a chapter. 


<CHAPTER> (Global Tag Descriptions\tags_chap) 


<P>This chapter includes descriptions of all global tags. The tags are 
listed alphabetically. 


See the beginning of this chapter for a sample chapter. 
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<CHEAD> 


<CHEAD> 


Specifies an unnumbered centered heading. 





SYNTAX <CHEAD> (heading text[ \ symbol name]) 





ARGUMENTS _ heading text 
Specifies the text of the heading. 


symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 





related tags * <CENTER_LINE> 
¢ <HEAD> 
¢ <HEADn> 


¢ <SUBHEADn> 





DESCRIPTION _ The <CHEAD> tag specifies an unnumbered centered heading. The heading 
does not appear in the table of contents. Use the <CHEAD> tag when the 
clarity of your document requires such a fine level of distinction. 


EXAMPLE The following example shows how to use the <CHEAD> tag. 
<CHEAD> (How to Use the <TAG>(chead) Tag\use_of_chead) 
<P>The use of centered headings should be restricted to occasions when the 


Clarity of your document absolutely requires one. 


This example produces the following output: 


How to Use the <CHEAD> Tag 


The use of centered headings should be restricted to occasions when the 
clarity of your document absolutely requires one. 


al, 
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<CHECK_FOR_INCLUSION> 


<CHECK FOR INCLUSION> 


Marks a definitions file to ensure that the file is read only once. 





SYNTAX <CHECK_FOR_INCLUSIONS (file label) 





ARGUMENTS _ file label 
Specifies a string that uniquely identifies this file. This string is not the 
name of the file; rather, it sets an internal switch to indicate that the 
following input should be read only once. The string can contain up to 
15 alphanumeric characters or underscores and must not begin with an 
underscore. 





restrictions You must put the <CHECK_FOR_INCLUSION> tag at the top of the definitions 
file and the <ENDCHECK_FOR_INCLUSION> tag at the bottom of the file. 





required <ENDCHECK_FOR_INCLUSION> 
terminator 





DESCRIPTION _ The <CHECK_FOR_INCLUSION> tag marks a definitions file to ensure that 
the file is read only once, because to force the tag translator to process the 
definitions twice would be a waste of processing time. The tag is useful: 


e For excluding the definitions file from being read when processing an 
individual element of a book, because the file has already been read for 
an entire bookbuild 


For excluding the definitions file from being read during a bookbuild if 
the source files already contain the same definitions 





EXAMPLE The following example shows how you can use the <CHECK_FOR_INCLUSION> 
tag to exclude a file (in this example, the file MY_DEFINITIONS_FILE) 
from being read during a bookbuild. 


<CHECK_FOR_INCLUSION> (MY_DEFINITIONS_FILE) 
<DEFINE>(ansi_long\ANSI General Purpose Subset (BSR X3.74)) 
<DEFINE>(ansi_short\ANSI GPSubset) 


<ENDCHECK_FOR_INCLUSION> 
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Identifies a number that is printed as a white letter in a black box or circle 
(depending on the output device) in an example. (The <CO> tag is identical to 
the <CALLOUT> tag.) 





SYNTAX <CO>/(number)] 





ARGUMENTS number 


This is an optional argument. It specifies the number of the callout. If you 
do not specify a callout number, the callouts are numbered sequentially. 





related tags * <CALLOUT> 
¢ = <CALLOUT_REF> 


¢ <CALLOUTS> 
¢ <LIST>(CALLOUT) 





restrictions Valid only in the context of a <CALLOUTS> tag. 


DESCRIPTION _ The <Co> tag identifies a number that is printed as a white letter in a 
black box or circle (depending on the output device) in an example. 


EXAMPLES See the examples in the discussion of the <CALLOUTS> tag. 


1-24 


<CODE_EXAMPLE> 


<CODE_EXAMPLE> 


Begins an example of code. Code consists of words or lines of instructions 
written in a programming language or a command language. 








SYNTAX <CODE_EXAMPLEs> (inline code example) 
KEEP 
<CODE_EXAMPLE>/(; WIDE [\ MAXIMUM] })/ 
MAXIMUM 
code example text 
<ENDCODE_EXAMPLE> 
ARGUMENTS __ inline code example 


Specifies code you want to insert into your text. 


If you do not use this argument, you must use the terminating tag 
<ENDCODE_EXAMPLE>. 


KEEP 


This is an optional keyword argument. It specifies that the example is 
not to be broken across pages; that is, if the example does not fit on the 
current page, it is placed on the next page. If the example itself does not 
fit on an entire single page of output, it is broken anyway. This keyword 
has no effect for Bookreader output. 


WIDE 


This is an optional keyword argument. It specifies that the width of the 
example exceeds the document’s default width for text. Depending on the 
doctype, this argument is interpreted as follows: 


e Ifthe doctype contains a left margin area that is normally used for 
headings, the example’s width spans that area as well as the normal 
text area. 


e Ifthe document uses a multicolumn format, the example suspends the 
multicolumn output while the example is processed. The example is 
output across two columns and then multicolumn output is restored. 


You must encase the code example in <EXAMPLE>, <FIGURE>, or <TABLE> 
tags in order to print the code example across two columns. 


¢ Depending on the doctype, this argument provides a range of font sizes 
and font styles for examples. 
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<CODE_EXAMPLE> 


related tags 


restrictions 


required 
terminator 


MAXIMUM 


This is an optional keyword argument. It specifies that the text of the 
code example is adjusted to a smaller point size in order to fit within the 
boundaries of the left and right margins of the page. You can use this 
keyword in conjunction with WIDE to indicate that the example may 
require additional adjustment to fit within the boundaries of the page. You 
should use this keyword with discretion, and it may not be suitable in all 
doctypes. 





e <INTERACTIVE> 
e <VALID_BREAK> 





Invalid in the context of a <FOOTNOTE> tag. 
You cannot use indexing tags (<X> and <Y> tags) in code examples. 


You cannot use tab characters to format code examples. You must use 
spaces. 


You cannot use text element tags within a code example (for example, <P>, 
<LIST>, or <NOTE> tags). 


If you use double hyphens within the <CODE_EXAMPLE>(code) tag, the double 
hyphens are converted to a single en dash. This does not occur if you use 
double hyphens in the context of the <CODE_EXAMPLE> and <ENDCODE_ 
EXAMPLE> tags. 





<ENDCODE_EXAMPLE> —Required if you do not provide the inline code 
example argument to the <CODE_EXAMPLE> tag. 


DESCRIPTION 


1-26 


The <CODE_EXAMPLE> tag begins an example of code. Code consists of 
words or lines of instructions written in a programming language or a 
command language. The code that is begun with a <CODE_EXAMPLE> tag 
is distinguished typographically in the output. The size of the example, 
whether it will be indented and how much it will be indented from the 
current left margin of text, is controlled by the doctype. 


Using the <CODE_EXAMPLE> tag makes the code example an informal 
example, in that the code example has no number or caption, cannot 
be referenced, and is not listed in the table of contents. If you enclose 
the code example within <EXAMPLE> and <ENDEXAMPLE> tags, however, 
the code example becomes a formal example; it then has a number and 
caption, can be referenced, and is listed in the table of contents. 


By default, informal code examples do not pop up when viewed with 
Bookreader; formal code examples do. If you want an informal code 
example to pop up, use the <ONLINE_POPUP> tag. 


There are two types of code examples. The first is a short fragment that 
you may want included with the surrounding text. In this case, enter 
the code as an argument to the <CODE_EXAMPLE> tag and do not use a 
terminating tag. 


<CODE_EXAMPLE> 


The second type of code example is one or more lines that you may 

want broken out of the text that surrounds it. In this case, enter the 
code between the <CODE_EXAMPLE> and <ENDCODE_EXAMPLE> tags. The 
character spaces and blank lines you enter to format the code are retained. 
You can also use the <ELLIPSIS> tag to achieve a vertical ellipsis showing 
that you have omitted some lines of code. If your code example is longer 
than a few lines, use the <VALID_BREAK> tag to indicate the acceptable 
points for a page break. 





EXAMPLES The following example shows a short code example that is run in with 


the surrounding text. The <VARIABLE> tag simply distinguishes a variable 
typographically. See the <VARIABLE> tag description for more information. 


<P>The <CODE_EXAMPLE>(WHILE INLOOP) statement causes the 
following block to be repeated until the <VARIABLE>(INLOOP) variable 
is set to FALSE. 


This example produces the following output: 


The WHILE INLOOP statement causes the following block to be repeated 
until the INLOOP variable is set to FALSE. 


The following example shows how to use the <CODE_EXAMPLE> tag with a 
longer example that is broken out of the surrounding text. In this case, 
you need the <ENDCODE_EXAMPLE> tag, because the code is not used as an 
argument to the <CODE_EXAMPLE> tag. 


<P>The call frame is built on the stack by the following four instructions: 
<CODE EXAMPLE> 
PUSHAB B*SRVEXIT 


PUSHL FP 
PUSHL AP 
CLRQ - (SP) 


<ENDCODE_EXAMPLE> 
This example produces the following output: 
The call frame is built on the stack by the following four instructions: 


PUSHAB B*SRVEXIT 


PUSHL FP 
PUSHL AP 
CLRQ - (SP) 


The following example shows a longer code example that uses the 
<ELLIPSIS> tag. 


<P>The instruction sequence listed here (patterned after code in 
module PROCSTRT) shows this second technique. 
<CODE_EXAMPLE> 


PUSHL executive-mode-PSL 
BSBB DOREI 

<ELLIPSIS> 

PUSHL user-mode-PSL 

BSBB DOREI 

<ELLIPSIS> 

DORET: REI 


<ENDCODE_EXAMPLE> 


This example produces the following output: 
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<CODE_EXAMPLE> 


The instruction sequence listed here (patterned after code in module 
PROCSTRT) shows this second technique. 


PUSHL executive-mode-PSL 
BSBB DOREI 

PUSHL user-mode-PSL 

BSBB DOREI 

DOREI: REI 
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<COMMENT> 


<COMMENT> 


Marks a section of an SDML file that you do not want to appear in your 
output. Text marked by a <COMMENT> tag is ignored by the tag translator 
during processing. 














SYNTAX <COMMENT> (comment text) 
. or 
<COMMENT> 
comment text 
<ENDCOMMENT> 
ARGUMENTS comment text | | ‘ 
Specifies the text you do not want to ‘appear in your output. This is a 
required argument, unless you use the <COMMENT> and <ENDCOMMENT> 
tags with comment text between the two tags. 
restrictions You cannot nest <COMMENT> tags. 
required <ENDCOMMENT> — Required if you do not specify an argument to the 
terminator <COMMENT> tag. 


DESCRIPTION 


The <COMMENT> tag marks a section of an SDML file that you do not want 
to appear in your output. Text marked by a <COMMENT> tag is ignored by 
the tag translator during processing. 


Comments can provide useful reminders for your own use or use by writers 
who may modify your SDML file in the future. You can also use comments 
to exclude portions of text from the output file that you want to save for 
later inclusion. The text remains in the SDML file, but does not appear in 
the output. 
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<COMMENT> 





EXAMPLE 


<CODE_EXAMPLE> 


Ne Ne Se 


-=0 
000000 C.CLK: - BLKW 
000002 C.CTCB: .BLKW 
000004 C.CUCB: .BLKW 
000006 C.CCT: - BLKW 
000010 cC.CSTS: .BLKW 
<COMMENT> 
000012 C.CMCD: 
000012 C.CSO: - BLKW 
<ENDCOMMENT> 
000014 C.CTR: . BLKW 
000015 C.BLK: - BLKW 
000016 C.CTXT: 


<ENDCODE_EXAMPLE> 
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The following example shows a code example with a comment embedded 
in the code. The tag translator ignores the text between the <COMMENT> 
and <ENDCOMMENT> tags. 


1 
1 
1 
1 
1 


1 


; LINK WORD 


SECONDARY POOL COMMAND BUFFER BLOCKS 


7;TCB ADDRESS OF TASK TO RECEIVE. COMMAND 
7;UCB ADDRESS IF RESPONSIBLE TERMINAL 
;CHARACTER COUNT, EXCLUDING TRAILING CR 
;STATUS MASK 


7; SYSTEM MESSAGE CODE 
;STARTING OFFSET OF VALID COMMAND TEXT 


1 ; TERMINATING CHARACTER 
1 ;SIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS 
;COMMAND TEXT, FOLLOWED BY CR 


This example produces the following output: 


000000 
000002 
000004 
000006 
000010 


000014 
000015 
000016 


SECONDARY POOL COMMAND BUFFER BLOCKS 


Me Ne Ne 


-=0 

C.CLK: -BLKW 1 ;LINK WORD 

C.CTCB: .BLKW 1 ;TCB ADDRESS OF TASK TO RECEIVE COMMAND 
C.CUCB: .BLKW 1 ;UCB ADDRESS IF RESPONSIBLE TERMINAL 

C.CCT: -BLKW 1 ;CHARACTER COUNT, EXCLUDING TRAILING CR 
C.CSTS: .BLKW 1 ;STATUS MASK 

C.CTR: -BLKW 1 ;TERMINATING CHARACTER 

C.BLK: -BLKW 1 ;SIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS 
C.CTXT: ;COMMAND TEXT, FOLLOWED BY CR 


<CONDITION> 


<CONDITION> 


Marks a section of an SDML file that is not processed unless one of the 
arguments to the tag matches the argument in the related <SET_CONDITION> 
tag or matches the condition you set with the /CONDITION qualifier on the 
DOCUMENT command line. 





SYNTAX 


<CONDITION> (condition name-1 [\ condition name-2] 
[\ condition name-3]) 
conditional text 


<ENDCONDITION> 


ARGUMENTS 


related tags 


restrictions 


required 
terminator 


condition name 
Specifies up to three condition names created with the <SET_CONDITION> 
tag. At least one condition name is required. 





¢ <SET_CONDITION> 





You cannot nest <CONDITION> tags. 


In monospaced examples, <CONDITION> and <ENDCONDITION> tags cannot 
occupy the same line as text for the example. 





<ENDCONDITION> 


DESCRIPTION 


The <CONDITION> tag marks a section of an SDML file that is not processed 
unless one of the arguments to the tag matches the argument in the 
related <SET_CONDITION> tag or matches the condition you set with the 
/CONDITION qualifier on the DOCUMENT command line. 


If the two tags’ arguments are identical, the marked text is processed and 
included in the output file. If the arguments differ, the text is excluded 
from processing. 


This tag can be very useful if you must produce two or more documents 
that differ in minor ways but contain much of the same text. It is efficient 
to maintain one SDML file and identify the portions of text that are unique 
to each document. 
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<CONDITION> 


Before processing the SDML file, you can specify the condition name 

for the desired document by using the <SET_CONDITION> tag or the 
/CONDITION qualifier on the DOCUMENT command line. When the 

tag translator processes the file, it includes all portions of text tagged with 
that condition name argument and ignores all portions of text tagged with 
any other condition name. To obtain another version of the document, 
change the condition name in the argument to the <SET_CONDITION> tag or 
change the /CONDITION qualifier and reprocess the file. 


When you supply more than one condition name argument to the 
<CONDITION> tag, only one of the condition names needs to be present 
for the conditional text to be processed. 





EXAMPLES The following example shows how you could organize a file if you were 
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writing about holidays in general, and Christmas, Chanukah, and 
Passover in particular. Any of three different condition states could 

be set at the top of your file with the <SET_CONDITION>(Christmas), <SET_ 
CONDITION>(Chanukah), or <SET_CONDITION>(Passover) tags. The example 
contains four paragraphs, with each paragraph conditionalized differently. 


If the file is processed with the <SET_CONDITION>(Christmas) tag, the 
information on Christmas and religious holidays is processed. If the 
file is processed with the <SET_CONDITION>(Chanukah) tag, the information 
on Chanukah and religious holidays is processed. If the file is processed 
with the <SET_CONDITION>(Passover) tag, the information on Passover is 
processed. 


The function of the <SET_CONDITION> tag can be obtained by using the 
/CONDITION qualifier on the DOCUMENT command line instead. 
See VAX DOCUMENT Producing Online and Printed Documentation 
or Appendix A for more information. 


<CONDITION> (Christmas) 
<P>Christmas, by convention, is celebrated on December 25th... 
<ENDCONDITION> 


<CONDITION> (Chanukah) 
<P>Chanukah is called the Festival of Lights... 
<ENDCONDITION> 


<CONDITION> (Passover) 
<P>Passover is usually celebrated... 
<ENDCONDITION> 


<CONDITION> (Christmas\Chanukah) 

<HEAD1> (Religious Holidays) 

<P>This paragragh contains general information about several religious 
holidays .. 

<ENDCONDITION> 


The following example shows how you can omit one of two clauses from 
processing based on the condition name specified in the <SET_CONDITION> 
tag. The section of text that is identified with <CONDITION>(VMS) would be 
processed and placed in the output file, whereas the other text would be 
omitted. 


<CONDITION> 


<SET_CONDITION> (VMS) 


When the 

<CONDITION> (VMS) VAX/VMS<ENDCONDITION> 

<CONDITION> (RSX) RSX11M/RSX11M-PLUS<ENDCONDITION> 

command language interpreter translates the logical name... 


This example produces the following output: 


When the VAX/VMS command language interpreter translates the logical 
name... 


The following example shows how you can differentiate text that is 
applicable to the two condition names (VMS and RSX) from text that 

is applicable to the condition name RSTS. By supplying both the VMS and 
RSX arguments to the first <CONDITION> tag, you ensure that the text is 
included in the output if either the VMS or RSX condition name is set. 
(Other text in the same SDML file might be conditional for only one of 
these condition names.) 


<SET_ CONDITION> (RSX) 
<P>When RSX... 


<CONDITION> (VMS\RSX) 
<P>When the operating system... 


<ENDCONDITION> 


<CONDITION> (RSTS) 
<P>When RSTS... 


<ENDCONDITION> 
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<CONTENTS FILE> 


<CONTENTS FILE> 


Specifies the position in a source file where a table of contents output file will 
be included; it does not produce a table of contents. 


+ 





SYNTAX 


<CONTENTS FILE>/(file spec)/ 





ARGUMENTS 


related tags 


restrictions 


file spec 

This is an optional argument. It specifies the name of the table of contents 
file. Use this argument if you want to include a table of contents file with 
a name other than the default file name. 


The default file name is file spec_contents.DVI_device. If you specify a file 
type, be sure that the device name matches the destination device you 
specify on the DOCUMENT command line. For example, if you specify 
file spec_contents.DVI_PS, be sure you specify PS as the destination on the 
command line. 





¢ <FRONT_MATTER> 
¢ <PROFILE> 





Valid only in the context of a <FRONT_MATTER> or <PROFILE> tag. This 
tag must occur within front matter or a profile in order for processing to 
continue. 





DESCRIPTION 
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The <CONTENTS_FILE> tag specifies the position in a source file where a 
table of contents output file will be included; it does not produce a table 
of contents. A contents file is produced when you specify the qualifier 
/CONTENTS on the DOCUMENT command line. 


It is recommended that you place the <CONTENTS_FILE> tag in the front 
matter file immediately before the <PREFACE> tag. This ensures correct 
placement of the table of contents in both printed and Bookreader output. 


A contents file always receives the filetype .DVI _device, where device is 
the type of output device you specified on the DOCUMENT command 
line. To generate a table of contents from an individual file that 
contains a <CONTENTS_FILE> tag, specify the /CONTENTS qualifier on 
the DOCUMENT command line. 


If you specify the /CONTENTS qualifier on the DOCUMENT command 
line without using the <CONTENTS_FILE> tag in your front matter file, a 
table of contents is generated separately from your document. For more 
information on generating a table of contents, see VAX DOCUMENT 
Producing Online and Printed Documentation. 


<CONTENTS_FILE> 


Because a table of contents is required for a book you create for 
Bookreader, a table of contents file is generated automatically if you 

do not use a <CONTENTS_FILE> tag or the /CONTENTS qualifier on the 
DOCUMENT command line. If you do use the <CONTENTS_FILE> tag in a 
Bookreader bookbuild, however, the tag must not precede the <TITLE_PAGE> 
tag. 





EXAMPLE 


To see the result of the <CONTENTS_FILE> tag, refer to the table of contents 
in this manual. See the example in the <FRONT_MATTER> tag description 
for an example of placing the <CONTENTS_FILE> tag before the <PREFACE> 
tag in the front matter of a book. 
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<COPYRIGHT_DATE> 


<COPYRIGHT DATE> 


Inserts a copyright date line on the copyright page along with other system- 
specific copyright information. 


SYNTAX <COPYRIGHT_DATE>(date/ | owner) 








ARGUMENTS _ date 


Specifies official printing date information for the book. 


owner | 
This is an optional argument. It specifies the owner of the copyright. 


Note: For Bookreader output, the arguments you specify are used 
to generate the copyright notice on the title page, not on the 


copyright page. 





related tags ° <COPYRIGHT_PAGE> 
¢ <FRONT_MATTER> 





restrictions Valid only in the context of a <COPYRIGHT_PAGE> tag, which you can use 
only within the front matter of a book. 


DESCRIPTION The <COPYRIGHT_DATE> tag inserts a copyright date line on the copyright 
page along with other system-specific copyright information. 


EXAMPLE The following example shows how to use the <COPYRIGHT_PAGE> tag to 
produce a full page of output. 

<FRONT_MATTER> (front) 

<COPYRIGHT PAGE> 

<COPYRIGHT DATE>(1990\Smith Publishing, Inc.) 


<ENDCOPYRIGHT_PAGE> 
<ENDFRONT_MATTER> 


This example produces the following output: 


Copyright ©1990 Smith Publishing, Inc. 
All Rights Reserved. 
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<COPYRIGHT_PAGE> 


<COPYRIGHT PAGE> 


Begins a copyright page and enables copyright page tags. 


SYNTAX <COPYRIGHT_PAGE> 


ARGUMENT None. 











related tags ¢ <COPYRIGHT_DATE> 
¢ <FRONT_MATTER> 
* <PRINT_DATE> 








restrictions Valid only in the front matter of a book. 
req uired <ENDCOPYRIGHT_PAGE> 
terminator 


DESCRIPTION _ The <COPYRIGHT_PAGE> tag begins a copyright page and enables copyright 
page tags. The following tags are enabled by the <COPYRIGHT_PAGE> tag: 


°¢ 6<PRINT_DATE> 
¢ <COPYRIGHT_DATE> 
DOCUMENT considers a copyright page to be an online topic. See VAX 


DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 





EXAMPLE The following example shows the order in which you can use the copyright 
page tags. The output of this example is a separate copyright page 
containing the print and copyright dates in the front matter of the book. 


<FRONT_MATTER> (front) 
<COPYRIGHT PAGE> 
<PRINT_DATE> (March 1987) 
<COPYRIGHT DATE> (1987) 
<ENDCOPYRIGHT_PAGE> 
<ENDFRONT_MATTER> 


To see an example of all the front matter tags in their correct order, see 
the example in the <FRONT_MATTER> tag description. 
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<CP> 


Marks the continuation of a paragraph that is interrupted by another text 
element, such as a figure, list, or a table. 





SYNTAX <CP> 





ARGUMENTS _ Nore. 





related tags ° <P> 





restrictions Invalid in the context of a <MATH> tag. 





DESCRIPTION = The <cp> tag marks the continuation of a paragraph that is interrupted by 
another text element, such as a figure, list, or a table. The <P> and <CP> 
tags may have no visible difference in effect. In a doctype in which all 
new paragraphs begin flush left, the formatted results achieved by a <CP> 
tag and by a <P> tag are identical. In a doctype in which paragraphs are 
indented, however, the continued paragraph may still begin flush left. 


In some instances, the <CP> tag keeps text that follows a list or 
monospaced example from being left alone at the top of the following 
page, which more closely attaches the continued paragraph to the previous 
text element. 





EXAMPLE The following example shows how to use the <CP> tag. Assume that the 
doctype is one in which paragraphs are indented. 


<P>Each time you log in, the system automatically executes 

two types of login command procedures: 

<LIST> (UNNUMBERED) 

<LE>A system login command procedure 

<LE>Your personal login command procedure 

<ENDLIST> 

<CP>These login procedures are described in the following sections. 


This example produces the following output: 


Each time you log in, the system automatically executes two types of 
login command procedures: 


¢ A-system login command procedure 


¢ Your personal login command procedure 


These login procedures are described in the following sections. 


<CPAREN> 


<CPAREN> 


Supplies a closing parenthesis anywhere in your file. You must use this tag, 
however, to specify a closing parenthesis within an argument to a tag, so that 
the closing parenthesis is not interpreted as the closing parenthesis of the 
tag’s argument. 





SYNTAX <CPAREN> 





ARGUMENTS = None. 





related tags ¢ The following tags label other characters that you must tag when they 
occur in an argument to a tag: 


<AMPERSAND> 

<BACKSLASH> 

<OPAREN>—required only if there is no closing parenthesis 
<VBAR> 





DESCRIPTION _ The <CPAREN> tag supplies a closing parenthesis anywhere in your file. 
You must use this tag, however, to specify a closing parenthesis within an 
argument to a tag, so that the closing parenthesis is not interpreted as 
the closing parenthesis of the tag’s argument. This tag is only beneficial 
(in terms of keystrokes and control of the output), then, as an unmatched 
closing parenthesis in an argument to a tag. 


An unmatched parenthesis in an argument can cause errors when 
processed, because the parentheses are used to determine the beginning 
and ending of an argument list. The <CPAREN> tag inserts the closing 
parenthesis character, but it is not evaluated as a closing parenthesis. 


EXAMPLE The following example shows how to use the <CPAREN> tag. The 
<PARENDCHAR> tag in this example simply provides better spacing of 
the right parenthesis within the parentheses. See the <PARENDCHAR> tag 
description for more information. 


<SUBHEAD1> (Using a Closing Parenthesis 
<PARENDCHAR> (<CPAREN>) in an Argument to a Tag\closing_paren) 


This example produces the following output: 


Using a Closing Parenthesis ()) in an Argument to a Tag 
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Produces either the current system or user-specified date and time. 





FULL 
<DATERI cate toxt 





ARGUMENTS 


restrictions 


FULL 
This is an optional keyword argument. It specifies a full VMS date and 


time string in the format “dd-mmm-yyyy hh:mm:ss.hh.” If you do not 
specify an argument, only the date may be produced in the format “Month 
day, year.” (The precise format varies in different doctypes.) 


date text 

This is an optional argument. It specifies text that you provide for the 
current date. If you do not specify an argument, only the date may be 
produced in the format “Month day, year.” (The precise format varies in 
different doctypes.) 


The following table specifies for all standard doctypes the output format of 
the <DATE> tag without arguments. 


Doctype Fomat Description <DATE> Tag Output 
REPORT Day—Month—Year 6—January—1990 
MILSPEC Day Month Year 6 January 1990 

All others Month Day, Year January 6, 1990 





Invalid in the context of a <MATH> tag. 





DESCRIPTION 


The <DATE> tag produces either the current system or user-specified date 
and time. 


Note that even if you specify the <DATE>(FULL) tag multiple times in a 
source file, it will always produce the same value. You cannot use it, 
therefore, for timing information. 


EXAMPLES 


anh 


The following example shows how to use the <DATE> tag. 


This example produces the following output: January 28, 1991 
The following example shows how to use the <DATE>(FULL) tag. 


<DATE> 


<DATE> (FULL) 
This example produces the following output: 28-JAN-1991 11:03:30.58 
The following example shows how to use the <DATE>(date text) tag. 
<DATE> (February 26, 1990 A.D.) 


This example produces the following output: February 26, 1990 A.D. 
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<DEFINE_BOOK_NAME> 





<DEFINE BOOK NAME> 


Defines the title of a book and associates a user-defined symbol name to the 
cross-reference file. 





SYNTAX 


<DEFINE_BOOK_NAME>(symbo!/ name \ title) 





ARGUMENTS 


related tags 


restrictions 


symbol name 

Specifies the symbol that is associated with the title of the book. Symbol 
names must not exceed 31 characters and must only include alphabetic 
letters, numbers, or underscores. Do not begin a symbol name with an 
underscore. 


title 
Specifies the exact text of the book’s title. 





e §6=<<DEFINE_SYMBOL> 
e <DELAYED> 
e <REFERENCE> 





If you want to nest a tag in the title argument, you must use the 
<DELAYED> tag to surround the nested tag. This causes the nested tag 
to be preserved until it is about to be output using the <REFERENCE> tag. 





DESCRIPTION 


ok, 


—42 


The <DEFINE_BOOK_NAME> tag defines the title of a book and associates 
a user-defined symbol name to the cross-reference file. When you 
subsequently reference the title with the <REFERENCE> tag, supplying 
the same symbol name as an argument to the <REFERENCE> tag, the 
book title is retrieved from the cross-reference file and is substituted for 
the reference. Depending on the doctype, the title may be output with 
emphasized text (for example, italicized text). 


Note that the symbol name argument is the first argument to the tag. In 
text element tags, the symbol name is always the second argument. Only 
the <DEFINE_BOOK_NAME> and <DEFINE_SYMBOL> tags take a symbol name 
as a first argument. Placing the symbol name as the first argument to 
these tags makes it easy to keep track of your symbol names when you list 
them in a local definitions file, where they are aligned and easy to find. 


<DEFINE BOOK_NAME> 





EXAMPLE The following example shows how to use the <DEFINELBOOK_NAME> tag 
for defining the symbol name of the book, Book of Games, Volume 2, as 
games_book. 


<DEFINE_BOOK_NAME>(games_book\Book of Games, Volume 2) 


You can use the <REFERENCE>(games_book) tag anywhere in the document to 
refer to the book by name. For example, you might say the following: 


<P>The authors suggest that you read the <REFERENCE>(games_book) 
before you try any of the more complex games. 


This example produces the following output: 


The authors suggest that you read the Book of Games, Volume 2 before you 
try any of the more complex games. 


<DEFINE_SYMBOL> 


<DEFINE_SYMBOL> 


Associates a string of text with a user-defined symbol, so that you can 
reference the text by this symbol throughout the document. 





SYNTAX 


<DEFINE_SYMBOL>(symbol name \ text string) 





ARGUMENTS 


related tags 


restrictions 


symbol name 


Specifies the name assigned to the symbol. Symbol names must not 
exceed 31 characters and must only include alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 


_ text string 


Specifies the text to be referenced by the symbol name. Throughout the 
document, you can specify the symbol name in the <REFERENCE> tag, and 
this text string is then substituted for the symbol name during processing. 





¢ <DEFINE_BOOK_NAME> 
¢ <DELAYED> 
¢ <REFERENCE> 





If you want to nest a tag in the text string argument, you must use the 
<DELAYED> tag to surround the nested tag. This causes the nested tag to 
be preserved until it is about to be output using the <REFERENCE> tag. 





DESCRIPTION 


Note: 


The <DEFINE_SYMBOL> tag associates a string of text with a user-defined 
symbol, so that you can reference the text by this symbol throughout the 
document. It adds the symbol name and the text to the symbol table. 
When you subsequently reference this text by using the <REFERENCE> tag 
and by specifying the same symbol name as its argument, the current 
value of the symbol name is retrieved from the table and the text is 
substituted for the reference. 


For more information on the use of the symbol table, see VAX 
DOCUMENT Producing Online and Printed Documentation. 


The symbol name argument to the <DEFINE_SYMBOL> tag must be 
on the same line as the tag; spaces and carriage returns are 
significant and are interpreted as part of the symbol name. 


Note that the symbol name argument is the first argument to the tag. In 
text element tags, the symbol name is always the second argument. Only 
the <DEFINE_BOOK_NAME> and <DEFINE_SYMBOL> tags take a symbol name 
as a first argument. Placing the symbol name as the first argument to 
these tags makes it easy to keep track of your symbol names when you list 
them in a local definitions file, where they are aligned and easy to find. 


<DEFINE_SYMBOL> 





EXAMPLES The following example shows how you can define the phrase, “RTL routine 


Set Logical Name, LIB$SET_LOGICAL,” as the symbol name, “set_ 
logical,” and then refer to it in text by that symbol name. By using the 
symbol name in the places you want the phrase to occur, you can save 
keystrokes and ensure that you never have a typing error in that phrase. 


<define_symbol>(set_logical\RTL routine Set Logical Name, LIBS$SET_LOGICAL, ) 


<P>The <REFERENCE>(set_logical) requests the calling process’s CLI to 
define or redefine a supervisor-mode logical name. 


This example produces the following output: 


The RTL routine Set Logical Name, LIB$SET_LOGICAL, requests the 
calling process’s CLI to define or redefine a supervisor-mode logical name. 


The following example uses the <DELAYED> tag within the argument to the 
<DEFINE_SYMBOL> tag, causing the <DELAYED> tag to be evaluated by the 
tag translator after the <DEFINE_SYMBOL> tag. 


The symbol TEMP_CHART_EX is associated with the text string that is 
enclosed by the <DELAYED> and <ENDDELAYED> tags. None of the enclosed 
tags will have been evaluated. 


<define_symbol>(temp_chart_ex\<delayed> 
<example> (Temperature Chart) 
<code_example> 
Centigrade 0 Fahrenheit 32 
Centigrade 100 Fahrenheit 212 
<endcode_example> 
<endexample> 
<enddelayed>) 


Subsequently, you can refer to the symbol name with a <REFERENCE> tag, 
as in the following example: 


<REFERENCE> (temp_chart_ex) 
Using this reference results in the following output: 


Example n—-n Temperature Chart 


Centigrade 0 Fahrenheit 32 
Centigrade 100 Fahrenheit 212 


<DEFINITION_LIST> 


<DEFINITION_LIST> 


Begins a definition list, which includes an item followed by its definition. 





SYNTAX <DEFINITION_LIST> 





ARGUMENTS = None. 





related tags ¢ <DEFINITION_LIST_HEAD> 
¢ <DEFLIST_DEF> 
¢ <DEFLIST_ITEM> 





required <ENDDEFINITION_LIST> 
terminator 


DESCRIPTION _ The <DEFINITION_LIST> tag begins a definition list, which includes an 
item, introduced by the <DEFLIST_ITEM> tag, followed by its definition, 
introduced by the <DEFLIST_DEF> tag. The definition list differs from a 
list created with the <LIST> tag in that the definition list items are not 
numbered or called out in any way. 


You can give the definition list a heading by using the <DEFINITION_LIST_ 
HEAD> tag. Each list can contain one or more items, using the <DEFLIST_ 
ITEM> tag, and each item can have a definition, using the <DEFLIST_DEF> 
tag. 


EXAMPLE The following example shows how to use the <DEFINITION_LIST> tag. 


<definition_list> 

<deflist_item>(Hargreaves, James\d. 1778.) 
<deflist_def>English inventor. 

<deflist_item>(Harris, Joel Chandler\Born 1848.\Died 1908.) 
<deflist_def>American author. 

<enddefinition_list> 


This example produces the following output: 


Hargreaves, James 
d. 1778. 


English inventor. 
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<DEFINITION_LIST> 


Harris, Joel Chandler 
Born 1848. 
Died 1908. 


American author. 
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<DEFINITION_LIST_HEAD> 


<DEFINITION_LIST_HEAD> 


Supplies the heading for a list of defined items you specify with the 
<DEFINITION_LIST> tag. 





SYNTAX <DEFINITION_LIST_HEAD> (heading text) 





ARGUMENTS heading text 


Specifies the text for a heading that precedes the definition list. 





related tags * <DEFINITION_LIST> 
* <DEFLIST_DEF> 
¢ <DEFLIST_ITEM> 





restrictions Valid only in the context of a <DEFINITION_LIST> tag. 


DESCRIPTION _ The <DEFINITION_LIST_HEAD> tag supplies the heading for a list of defined 
items you specify with the <DEFINITION_LIST> tag. 


EXAMPLE The following example shows how to use the <DEFINITION_LIST_HEAD> tag. 


<definition_list> 
<definition_list_head>(Worldwide Associates) 
<deflist_item> (IAAF) 

<deflist_def> 

International Amateur Athletic Federation 
<deflist_item> (IAEA) 

<deflist_def> 

International Atomic Energy Agency 
<enddefinition_list> 


This example produces the following output: 


WORLDWIDE JAAF 
ASSOCIATES International Amateur Athletic Federation 


IAEA 


International Atomic Energy Agency 


al, 
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<DEFLIST_DEF> 


<DEFLIST_DEF> 


Introduces an item’s definition in a definition list. 


SYNTAX <DEFLIST_DEF> 








ARGUMENTS _ None. 





related tags ¢ <DEFINITION_LIST> 
¢ <DEFINITION_LIST_HEAD> 
¢ <DEFLIST_ITEM> 





restrictions Valid only in the context of a <DEFINITION_LIST> tag. 





DESCRIPTION _ The <DEFLIST_DEF> tag introduces an item’s definition in a definition list. 
Specify the item by using the <DEFLIST_ITEM> tag and specify the definition 
list by using the <DEFINITION_LIST> tag. 





EXAMPLE See the example in the discussion of the <DEFINITION_LIST> tag. 


<DEFLIST_ITEM> 


<DEFLIST_ITEM> 


Marks an item you want to define in a definition list. 





SYNTAX <DEFLIST_ITEM>(item-1 [\ item-2... [\ item-7]]) 





ARGUMENTS _ item 


Specifies the item you want to define. You can specify up to seven items. 





related tags * <DEFINITION_LIST> 
¢ <DEFINITION_LIST_HEAD> 
* <DEFLIST_DEF> 





restrictions Valid only in the context of a <DEFINITION_LIST> tag. 





DESCRIPTION _ The <DEFLIST_ITEM> tag marks an item you want to define in a definition 
list. A definition list contains paired entries, consisting of the item being 
defined, introduced by the <DEFLIST_ITEM> tag, and the item’s definition, 
introduced by the <DEFLIST_DEF> tag. 





EXAMPLE See the example in the discussion of the <DEFINITION_LIST> tag. 
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<DELAYED> 


<DELAYED> 


Allows you to specify text that contains a tag in an argument to another 
tag. Execution of the <DELAYED> tag is delayed until the outer tag’s text is 
processed. 








SYNTAX <DELAYED> (delayed text) 
or 
<DELAYED> 
delayed text 
<ENDDELAYED> 
ARGUMENTS _ delayed text 


related tags 


Specifies the text containing tags whose execution is delayed until the text 
is output. 





e <DEFINE_BOOK_NAME> 
¢ <DEFINE_SYMBOL> 
Any tag that takes a symbol name argument 











restrictions The <DELAYED> tag cannot be nested within itself. 
You must use this tag if you want to nest a tag in the argument of a tag 
that also takes a symbol name argument. 
required <ENDDELAYED> —Required if you do not specify an argument to the 
terminator <DELAYED> tag. 
DESCRIPTION — The <DELAYED> tag allows you to specify text that contains a tag in an 


argument to another tag. Execution of the <DELAYED> tag is delayed until 
the outer tag’s text is processed. 


Using a tag within an argument to another tag is called nesting a tag in 
an outer tag’s argument. Normally, the tag translator evaluates the nested 
tag first, then evaluates the outer tag. 
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<DELAYED> 


When you want the outer tag to be processed before the nested tag, you 
must use the <DELAYED> tag to surround the nested tag. For example, 
when the outer tag is the <DEFINE_SYMBOL>(symbol name\ text string) tag, you 
must use the <DELAYED> tag to surround the nested tag in the text string 
argument. This causes the nested tag to be preserved until it is about to 
be output using the <REFERENCE> tag. 





EXAMPLE The following example shows how to use the <DELAYED> tag. The symbol 
TEMP_CHART_EX is associated with the text string that is enclosed by 
the <DELAYED> and <ENDDELAYED> tags. None of the enclosed tags will 
have been evaluated. 


<define symbol>(temp_chart_ex\<delayed> 
<example> (Temperature Chart) 
<code_example> 
Centigrade 0 Fahrenheit 32 
Centigrade 100 Fahrenheit 212 
<endcode_example> 
<endexample> 
<enddelayed>) 


Subsequently, you can refer to the symbol name with a <REFERENCE> tag, 
as in the following example: 


<REFERENCE> (temp_chart_ex) 
Using this reference results in the following output: 


Example n-n Temperature Chart 


Centigrade 0 Fahrenheit 32 
Centigrade 100 Fahrenheit 212 
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<DOCTYPE> 


<DOCTYPE> 


Identifies the doctype for your file. This tag is for informational purposes only. 





SYNTAX <DOCTYPE> (document type) 





ARGUMENTS document type 


Specifies the doctype you want to use for your file. 


DESCRIPTION _ The <DOCTYPE> tag identifies the doctype for your file. This tag is for 
2 informational purposes only; it does not designate the doctype. 


You can include this tag anywhere in your file for informational purposes. 
You do not have to include the <DOCTYPE> tag in your file in order to 
process your file, however. Instead, you must specify the doctype on the 
DOCUMENT command line, which allows you to process your file using 
different doctypes to determine which one suits your needs. 


EXAMPLE The following example cnawis how you can identify a badk’s doctype as 
“REPORT”. Refer to VAX DOCUMENT Using Doctypes and Related Tags 
for sample output of the various doctypes. 


<DOCTYPE> (report) 
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<DOUBLE_ QUOTE> 


<DOUBLE_QUOTE> 


Supplies a double quotation mark as it appears when it is typeset. 


SYNTAX <DOUBLE_QUOTE> 








ARGUMENTS ~ None. 





related tags * <PARENDCHAR> 
¢ <QUOTE> 


¢ = <SINGLE_QUOTE> 





DESCRIPTION = The <DOUBLE_QUOTE> tag supplies a double quotation mark as it appears 
when it is typeset. This is different from the double quotation mark that 
your keyboard produces. 


Your keyboard has two possible characters you can use for quotation 
marks: the double quote, (") (ASCII 34) and the single quote (’ ) (ASCII 
39). In programming languages, a quoted string usually begins and ends 
with the same character, either "a quoted string," or 'a quoted string.’ 
Using the double or single quotation marks from your keyboard is usually 
adequate for showing examples of user input or screen displays. 


If you want your output to show a double quotation mark as it is appears 
when it is typeset, however, use the <DOUBLE_QUOTE> tag. 


If you want your output to follow typesetting conventions by using distinct 
opening and closing quotation marks, use the <QUOTE> tag instead of 
double quotation marks from your keyboard. You would use the <QUOTE> 
tag, for example, in citing a passage from another book. See the <QUOTE> 
tag description for more information. 


. 
EXAMPLES The following example shows how to use the <DOUBLE_QUOTE> tag. 


<P>You can cause the translation of a symbol by using a double 
quotation mark (<DOUBLE_QUOTE>) directly in front of it. 


This example produces the following output: 


You can cause the translation of a symbol by using a double quotation 
mark (") directly in front of it. 


The following example shows what your output would be like without 
using the tag, but just entering the double quotation mark character from 
the keyboard. 
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<DOUBLE_QUOTE> 


<P>You can cause the translation of a symbol by using a double 
quotation mark (") directly in front of it. 


This example produces the following output: 


You can cause the translation of a symbol by using a double quotation 
mark (") directly in front of it. 
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<ELEMENT> 


<ELEMENT> 


Identifies a file that contains an element of a book. 





SYNTAX <ELEMENT? (file spec) 





ARGUMENTS __ file spec 
Specifies a file. You must supply the file type (for example, .sdml). 





related tags ¢ <INCLUDES_FILE> 
¢ <PROFILE> 





restrictions Valid only in the context of a <PROFILE> tag. 


DESCRIPTION _ The <ELEMENT> tag identifies a file that contains an element of a book. A 
profile of a book is required in order to build (process) a book. A book’s 
profile contains an ordered list of the elements that comprise the book. In 
the profile, you label each of these elements with an <ELEMENT> tag. Only 
those files listed with <ELEMENT> tags are included in the book during the 
bookbuild. List those files in the profile according to the order in which 
they appear in the book. 


A file specified as an element must begin with one of the following tags: 
© <APPENDIX> 

¢ <CHAPTER> 

¢ <FRONT_MATTER> 

¢ <GLOSSARY> 

¢ <PART> 


For more information on creating a profile and bookbuilding, see VAX 
DOCUMENT Producing Online and Printed Documentation. 


EXAMPLE Assume that a writer is writing a book that contains several chapters. 
One of the chapters is the file My_Intro_Chap.SDML. At the top of this file 
is included the <CHAPTER>(Introduction\ intro_chap) tag to distinguish it 
as a chapter. 


Along with the other <ELEMENT> tags for this book, the profile would then 
contain the following: . 


<ELEMENT>(My_Intro_Chap.SDML) 


1-56 


<ELEMENT> 


See the example in the <PROFILE> tag description to see how to arrange 
the <ELEMENT> tags in a profile. 
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<ELLIPSIS> 


<ELLIPSIS> 


Supplies vertical ellipsis points to show omitted material in text and tables. 





SYNTAX <ELLIPSIS> 





ARGUMENTS ~ None. 





related tags ° <HELLIPSIS> 





restrictions Invalid in the context of a <MATH> tag. 


Place the tag alone on a line in monospaced examples, or else the first 
“dot” of the ellipsis will be misaligned. 


DESCRIPTION _ The <ELLIPSIS> tag supplies vertical ellipsis points to show omitted 
material in text and tables. The vertical ellipsis is positioned with respect 
to the current left margin. 


EXAMPLES The following example shows how to use the <ELLIPSIS> tag. 


| <P>The instruction sequence listed here (patterned after code in 
module PROCSTRT) shows this second technique. 
<CODE_EXAMPLE> 


PUSHL executive-mode-PSL 
BSBB DOREI 

<ELLIPSIS> 

PUSHL user-mode-PSL 

BSBB DORET 

<ELLIPSIS> 

DOREI: REI 


<ENDCODE _EXAMPLE> 


This example produces the following output: 


The instruction sequence listed here (patterned after code in module 
PROCSTRT) shows this second technique. 


PUSHL executive-mode-PSL 
BSBB DOREI 

PUSHL user-mode-PSL 

BSBB DOREI 

DORET: REI 


The following example shows how you can use the <ELLIPSIS> tag in a 
table. 


<ELLIPSIS> 


<TABLE> (Rules for Determining Expression Modes\express_modes_tab) 
<TABLE ATTRIBUTES> (MULTIPAGE) 
<TABLE_SETUP> (2\43): 
<TABLE_HEADS>(Expression\Value Type) 
<TABLE _ROW>(Integer value\Integer) 
<TABLE ROW> (<ELLIPSIS>\<ELLIPSIS>) 
<TABLE _ROW> (String value\String) 
<TABLE_ROW> (Integer lexical function\Integer) 
<TABLE_ROW> (String lexical function\<ELLIPSIS>) 
<TABLE_ROW> (Integer symbol\Integer) 
<TABLE ROW>(String symbol\String) 
<TABLE ROW>(Any value .AND. or .OR. any value\Integer) 
<TABLE _ROW>(Any value\Integer) 
<TABLE _ROW>(Any value\Integer) 

<ENDTABLE> 


This example produces the following output: 


Table n—n Rules for Determining Expression Modes 








Expression Value Type 
Integer value Integer 
String value String 
Integer lexical function Integer 


String lexical function 


Integer symbol Integer 
String symbol String 

Any value .AND. or .OR. any value Integer 
Any value Integer 
Any value Integer 
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<EMPHASIS> 


<EMPHASIS> 


Marks a word or phrase for distinctive typographical treatment. 





SYNTAX ~-( \ [BOLD] 


\ [ITALIC] 
<EMPHASIS> (text | [SMALLCAPS] ) 


| [SMALL_BOLDCAPS] 





ARGUMENTS TEXT 


Specifies the text you want to emphasize. 


BOLD 


This is an optional keyword argument and must be the second argument if 
used. It specifies that the text be set in a bold font. 


ITALIC 

This is an optional keyword argument and must be the second argument if 
used. It specifies that the text be set in the current italic font. This is the 
default. 


SMALLCAPS 


This is an optional keyword argument and must be the second argument if 
used. It specifies that the text be set in small capital letters. 


SMALL_BOLDCAPS 


This is an optional keyword argument and must be the second argument if 
used. It specifies that the text be set in small capital letters in a bold font. 





related tags * <QUOTE> 
| °  <UNDERLINE> 





DESCRIPTION The <EMPHASIS> tag marks a word or phrase for distinctive typographical 
Pee a treatment. The default form of emphasis is to set the text in an italic font. 
Use one of the arguments to change the emphasis to another font. 


EXAMPLE The following example shows how to use the <EMPHASIS> tag. 
<P>An <EMPHASIS>(overuse) of the <TAG>(EMPHASIS) tag | 
<EMPHASIS>(inevitably\bold) ALWAYS 

<EMPHASIS>(reduces\small_boldcaps) its 

<EMPHASIS> (effectiveness\smallcaps) . 


This example produces the following output: 


1-60 


<EMPHASIS> 


An overuse of the <EMPHASIS> tag inevitably ALWAYS REDUCES its 
EFFECTIVENESS. 
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<ENDCOPYRIGHT_PAGE> 


<ENDCOPYRIGHT_PAGE> 


Terminates the copyright page and optionally provides text that is output at the 
bottom of the copyright page. 





SYNTAX <ENDCOPYRIGHT_PAGE>/(identification)] 





ARGUMENTS __ identification 
This argument is optional. It specifies a local convention for information 
on the copyright page. 





related tags ¢ <COPYRIGHT_PAGE> 
¢ <FRONT_MATTER> 
¢ <PRINT_DATE> 





restrictions Use only to terminate a <COPYRIGHT_PAGE> tag. You can only use the 
copyright page in the context of the <FRONT_MATTER> tag. 





DESCRIPTION _ The <ENDCOPYRIGHT_PAGE> tag terminates the copyright page and 
optionally provides text that is output at the bottom of the copyright 


page. 


EXAMPLE The following example shows the order in which to use the copyright page 

tags. The output of this example is a separate copyright page in the front 
matter of the book, and the page contains the print and copyright dates. 
The argument to the <ENDCOPYRIGHT_PAGE> tag, “ZK5352”, is a local 
identification number that appears at the bottom of the copyright page. 


<FRONT_MATTER> (front) 
<COPYRIGHT PAGE> 
<PRINT_DATE>(November 1990) 
<COPYRIGHT_DATE> (1990) 
<ENDCOPYRIGHT_PAGE> (Z2K5352) 
<ENDFRONT_MATTER> 


To see an example of all the front matter tags in their correct order, see 
the example in the <FRONT_MATTER> tag description. 


See the copyright page of this manual for a sample copyright page. 


oud, 
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<ENDPART_PAGE> 


<ENDPART_PAGE> 


Terminates a part page (which is a dividing page between major sections of a 
document) and optionally specifies paging attributes for text that follows. 





SYNTAX <ENDPART_PAGE>/(RENUMBER)] 





ARGUMENTS RENUMBER 
This is an optional keyword argument. It specifies that page numbering 
following the part page begins with 1. If you do not use this argument, 
page numbering continues following the part page with the next odd- 
numbered page. 


Using this argument has no effect on Bookreader output. 





related tags ° <PART_PAGE> 





restrictions Use only to terminate a <PART_PAGE> tag. 


DESCRIPTION _ The <ENDPART_PAGE> tag terminates a part page and optionally specifies 
paging attributes for text that follows. 


EXAMPLE See the example in the discussion of the <PART> tag. 
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<ENDTITLE_PAGE> 


<ENDTITLE_PAGE> 


Terminates a title page and optionally specifies text to appear at the bottom of 
the title page. 





SYNTAX <ENDTITLE_PAGE>/(text)] 





ARGUMENTS _ text 
This is an optional argument. It specifies that a line of text appear at the 
bottom of the title page. 





related tags ° <PART_PAGE> 





restrictions Use only to terminate a <TITLE_PAGE> tag. 





DESCRIPTION _ The <ENDTITLE_PAGE> tag terminates a title page and optionally specifies 
text to appear at the bottom of the title page. 





EXAMPLE The following example shows how to code a title page of a short document. 
See the example in the discussion of the <FRONT_MATTER> tag for an 
example of using this tag in the front matter of a book. 


<TITLE PAGE> 


<TITLE> (How to Code your SDML Source Files) 
<ENDTITLE PAGE>(This is for informational purposes only.) 
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<EXAMPLE> 


<EXAMPLE> 


Labels the beginning of an example. 





SYNTAX <EXAMPLE>/(example caption[ \ symbol name])] 





ARGUMENTS ~~ example caption 
This is an optional argument. It specifies the text of the caption to be 
associated with the example. The example caption and the associated 
example number will be included in the table of contents of the document. 


symbol name . 

This is an optional argument. It specifies the symbolic identifier to be 
associated with the example. The symbol name is assigned a numeric 
value, which is the current example number. The symbol and its value are 
placed in the symbol table. 


Symbol names must not exceed 31 characters and must only include 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





related tags ° = <CODE_EXAMPLE> 
¢ <EXAMPLE_ATTRIBUTES> 


¢ <EXAMPLE_FILE> 

¢ <EXAMPLE_SPACE> 
¢ <INTERACTIVE> 

¢ <REFERENCE> 

e = 6<S> 

¢ <SAMPLE_TEXT> 

e <U> 


¢ <VALID_BREAK> 





restrictions Cannot contain any text element tags, such as <CHAPTER>, <FIGURE>, 
<MATH>, <LIST>, <P>, or <TABLE>. 


Invalid in the context of a <FOOTNOTE> tag. 


Can only contain text that you label with <CODE_EXAMPLE>, <INTERACTIVE>, 
and <SAMPLE_TEXT> tags. Use a <P> tag within the context of the <SAMPLE_ 
TEXT> tag to provide paragraph format of the sample text. 


If you use an <EXAMPLE_FILE> tag in the context of an <EXAMPLE> tag, 
that file included by the <EXAMPLE_FILE> tag must contain either a code 
example (using the <CODE_EXAMPLE> tag) or an interactive example (using 
the <INTERACTIVE> tag). 
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<EXAMPLE> 


required 
terminator 





<ENDEXAMPLE> 


DESCRIPTION 


1-66 


The <EXAMPLE> tag labels the beginning of a formal example or 
informal example. A formal example is an example that has a number 
and a caption, can be referenced, and is listed in the table of contents. 
An informal example does not have a number or a caption, cannot be 
referenced, and is not listed in the table of contents. Moreover, you create 
an informal example with the <CODE_EXAMPLE> tag. See the <CODE_ 
EXAMPLE> tag description for more information. 


You can create a formal example in a number of ways: 


e By including a specified file in your example by using the <EXAMPLE_ 
FILE> tag 


e By leaving space for an example to be pasted in during final production 
by using the <EXAMPLE_SPACE> tag 


e By using text labeled with <CODE_EXAMPLE>, <INTERACTIVE>, <S>, 
<SAMPLE_TEXT>, and <U> tags 


You cannot use tables, lists, paragraphs, and other text elements in a 
formal example. You can, however, use a <P> tag within the context of a 
<SAMPLE_TEXT> tag to provide paragraph format of the sample text. See 
the <EXAMPLE_SEQUENCE> tag description in VAX DOCUMENT Using 
Doctypes and Related Tags for information about how to construct an 
example sequence that can include a variety of text elements. 


If the body of the example spans more than a single page of text, the 
example caption is repeated on each page on which the example continues. 


If the example is more than a page, page breaks are handled automatically 
by the text processor. You can control the page breaking by using <PAGE> 
tags to specify explicit page breaks, or <VALID_BREAK> tags within the 
example to specify good breaking points. If you explicitly break a page by 
using the <PAGE> or <VALID_BREAK> tags, the example caption is continued 
on the following page, as it is if the page is broken automatically by the 
text processor. 


When a floating figure or floating example precedes a multipage table (all 
tables not marked with the KEEP keyword are multipage), a succession of 
short pages may occur before the page on which the table begins. This is 
because a multipage table forces any previous floating figures or examples 
to be output before the table begins. 


If this situation occurs, code the preceding floating figures or examples 
with the KEEP keyword so that they will be kept with the text preceding 
them, resulting in better-balanced pages. 


See the description of the FLOAT keyword argument to the <EXAMPLE_ 
ATTRIBUTES> tag for information about floating figures or examples. 


<EXAMPLE> 


Note the following when processing a book for Bookreader display: 


e You must use the symbol name argument to process a formal example 
for Bookreader display. 


¢ DOCUMENT automatically creates pop-up windows for all formal 
examples. 


e When introducing and cross-referencing a formal example, you must 
use the <REFERENCE> tag to create a hotspot. Hotspots are regions in 
the windows you click on with your mouse to access cross-referenced 


topics. 


e You can use the <ONLINE_POPUP> tag if you want to make informal 
examples pop up. 





EXAMPLES The following example shows a one-page example that uses the WIDE 
argument of the <EXAMPLE_ATTRIBUTE> tag. The contents of the example 
are included using the <EXAMPLE_FILE> tag. The file that is included must 
contain either a code example or interactive example. 


<EXAMPLE> (VAXcluster Multi-file Summary\multi_file_exam) 
<EXAMPLE ATTRIBUTES> (WIDE) 
<EXAMPLE FILE>(monitor_multi_file_summary.sdml) 
<ENDEXAMP LE> 


This example produces the following output: 


Example n—-n_ VAXcluster Multi-file Summary 





+----- + VAX/VMS Monitor Utility 
{| AVE } TIME IN PROCESSOR MODES 
t—---- + MULTI-FILE SUMMARY 
Node: MOE CURLEY LARRY 
From: 15-APR-1984 18:17 15-APR-1984 18:17 15-APR-1984 18:17 Row Row Row 
To: 15-APR-1984 20:17 15-APR-1984 20:17 15-APR-1984 20:17 Sum Average Minimum 
Interrupt Stack 6.51 0.50 6.25 13.2 4.4 0.50 
Kernel Mode 25.73 0.42 12.43 38.5 12.8 0.42 
Executive Mode 9.46 0.95 1.81 12.2 4.0 0.95 
Supervisor Mode 1.97 0.00 0.16 2.1 0.7 0.00 
User Mode 13.24 5.33 56.14 74.7 24.9 5.33 
Compatibility Mode 0.00 0.07 0.00 0.0 0.0 0.00 
Idle Time 23.61 0.02 92.63 116.2 38.7 0.02 
prem nn + VAX/VMS Monitor Utility 
| AVE | PAGE MANAGEMENT STATISTICS 
+o---— + MULTI-FILE SUMMARY 
Node: MOE CURLEY LARRY 
From: 15-APR-1984 18:17 15-APR-1984 18:17 15-APR-1984 18:17 Row Row Row 
Tos: 15-APR-1984 20:17 15-APR-1984 20:17 15-APR-1984 20:17 Sum Average Minimum 
Page Fault Rate 36.73 8.81 0.49 46.0 15.3 0.49 
Page Read Rate 14.28 4.71 0.00 19.0 6.3 0.00 
Page Read I/O Rate 1.20 0.70 0.00 Le 0.6 0.00 
Page Write Rate 0.00 0.00 0.00 0.0 0.0 0.00 
Page Write I/O Rate 0.00 0.00 0.00 0.0 0.0 0.00 





Example n—n (continued on next page) 
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<EXAMPLE> 


Example n—n (Cont.) VAXcluster Multi-file Summary 





Free List Fault Rate 8.60 1.40 0.24 10.2 3.4 0.24 
Modified List Fauit Rate 5.83 2.29 0.00 8.1 2.7 0.00 
Demand Zero Fault Rate 12.96 1.68 0.24 14.8 4.9 0.24 
Global Valid Fault Rate 8.10 2.69 0.00 10.8 3.6 0.00 
Wrt In Progress Fault Rate 0.00 0.00 0.00 0.0 0.0 0.00 
System Fault Rate 4.92 0.53 0.18 5.6 1.8 0.18 
Free List Size 7586.30 8630.14 9665.06 25881.5 8627.1 7586.30 


Modified List Size 87.69 324.07 32.12 443.8 147.9 32.12 
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The following example shows how to use the <CODE_EXAMPLE> and 
<ENDCODE_EXAMPLE> tags in an informal example. 


<EXAMPLE> 

<CODE_EXAMPLE> 

$! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name’s initial. 

$! 


$ NODE :==/FSLOGICAL("SYSSNODE") ‘ 
$ SET PROMPT="/ / FSEXTRACT (1,1,NODE)/’:" 
$! 


<ENDCODE _EXAMPLE> 
<ENDEXAMP LE> 


This example produces the following output: 


a! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name’s initial. 

ot 


$ NODE :=='’FSLOGICAL ("SYSSNODE") ’ 
$ SET PROMPT="’/FSEXTRACT(1,1,NODE)’:" 
$! 


The following example shows how to use the <CODE_EXAMPLE> and 
<ENDCODE_EXAMPLE> tags in a formal example. 


<EXAMPLE> (Login Commands\login_exam) 
<CODE_EXAMPLE> 


$! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name’s initial. 

$! . 

$ NODE :=='’FSLOGICAL("SYSSNODE") ’ 

$ SET PROMPT=""/FSEXTRACT(1,1,NODE)’:" 

$! 

<ENDCODE_EXAMPLE> 

<ENDEXAMP LE> 


This example produces the following output: 


<EXAMPLE> 


Example n—n Login Commands 





$! 

$! The next two lines redefine the cmd. line prompt to be the node 
$! name’s initial. 
$! 


$ NODE :==’FSLOGICAL("SYS$NODE") ’ 
$ SET PROMPT="'’FSEXTRACT(1,1,NODE)/’:" 
$! 





The following example shows how to use the <INTERACTIVE>, 
<ENDINTERACTIVE>, <S>, and <U> tags within an example. Note that you 
should specify whatever space follows the system prompt within the <S> 
tag. 


<P>If you do not specify the full command line, DCL will prompt 

you for the missing information. For example, if you do not specify an 
input file and an-output file when you enter the COPY command, you will 
be prompted as follows: 

<EXAMPLE> (Using the COPY Command\using_copy_ command) 

<INTERACTIVE> 

<S>($ )<U>(COPY) 

<S>($_From: )<U> (INTERACT. SDML) 

<S>($_To: )<U>(NEWFILE.SDML) 

<ENDINTERACTIVE> 

<ENDEXAMP LE> 


This example produces the following output: 


If you do not specify the full command line, DCL will prompt you for the 
missing information. For example, if you do not specify an input file and 
an output file when you enter the COPY command, you will be prompted 
as follows: 


Example n—n Using the COPY Command 
$ COPY 


$ From: INTERACT. SDML 
$ To: NEWFILE.SDML 





The following example shows how to use the <SAMPLE_TEXT> tag within the 
<EXAMPLE> and <ENDEXAMPLE> tags to get specially formatted sample text 
within a formal example. 


<EXAMPLE>(Some Sample Text\sample_text) 

<SAMPLE_ TEXT> 

<P>This paragraph shows how to use the <SAMPLE TEXT> tag within the 
<EXAMPLE> and <ENDEXAMPLE> tags to get specially formatted sample 
text within a formal example. 

<ENDSAMPLE_ TEXT> 

<ENDEXAMPLE> 


This example produces the following output: 
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<EXAMPLE> 


Example n-n Some Sample Text 
This paragraph shows how to use the <SAMPLE_TEXT> 


tag within the <EXAMPLE> and <ENDEXAMPLE> tags to get 
specially formatted sample text within a formal example. 
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<EXAMPLE_ATTRIBUTES> 


<EXAMPLE_ATTRIBUTES> 


Specifies attributes for the current example. 








SYNTAX FLOAT 
<EXAMPLE_ATTRIBUTES>(? KEEP 
| MULTIPAGE 
[\ WIDE]) 
ARGUMENTS FLOAT 


Specifies whether the location of a one-page example is allowed to fioat. 
FLOAT indicates that if there is not enough room on the current page 
for the example, the text processor will fill the current page with the text 
from the source file that follows the <EXAMPLE> tag sequence, and place 
the example at the top of the next page of output. 


Float is the default for an example that has a caption and does not specify 
MULTIPAGE or KEEP. FLOAT has no effect for Bookreader output. 


KEEP 


Specifies whether the example is to be kept with the text that immediately 
precedes it. KEEP has no effect for Bookreader output. 


MULTIPAGE 


Specifies that the example has multiple elements, and that each element 
is allowed to break at the start of a new page. This argument is required 
if the example elements require more than one page. When an example is 
continued, the example caption is automatically repeated at the beginning 
of each new page of output. MULTIPAGE has no effect for Bookreader 
output. 


WIDE 


This is an optional keyword argument. It specifies that the width of the 
example exceeds the document’s default width for text. You can use WIDE 
with FLOAT, KEEP, or MULTIPAGE, or you can use WIDE as the only 
argument. Depending on the doctype, this argument is interpreted as 
follows: 


e Ifthe doctype contains a left margin area that is normally used for 
headings, the example’s width will span that area as well as the 
normal text area. 


¢ Ifthe document uses a multicolumn format, the example suspends 
multicolumn output while the example is processed. The example is 
output across two columns and then multicolumn output is restored. 


e Depending on the doctype, this argument provides a range of font sizes 
and font styles for examples. 
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<EXAMPLE_ATTRIBUTES> 


related tags 


restrictions 





¢ <EXAMPLE> 


-@  <EXAMPLE_FILE> 


¢ <EXAMPLE_SPACE> 
¢ <REFERENCE> 





Valid only in the context of an <EXAMPLE> tag. 
X 


DESCRIPTION 


The <EXAMPLE_ATTRIBUTES> tag specifies attributes for the current 
example. By default, if an example does not fit on the current output 
page, it is placed at the top of the next page. The text that follows the 
example in the SDML file is used to fill the current output page. Thus, 
the example’s position in the text may change. It is said to float. Formal 
examples that float, then, may appear out of place. Use the <EXAMPLE_ 
ATTRIBUTES>(KEEP) tag to force the formal example to be kept with the text 
that immediately precedes it. 


If you think the example will be longer than a page, use the MULTIPAGE 
keyword argument to indicate that the example requires more than one 
page of output. The example will not be allowed to float. 


If the example is formal and you want to align the caption with the 
example (that has been extended into the left column), use the WIDE 
argument with both the <EXAMPLE_ATTRIBUTES> and <CODE_EXAMPLE> 
tags. 





EXAMPLE 
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This example shows how to use the MULTIPAGE and WIDE arguments to 
the <EXAMPLE_ATTRIBUTES> tag. Note the following: 


e The <VALID_BREAK> tags in the <CODE_EXAMPLE> provide the text 
formatter with information about suitable places to break pages. 


¢ Because the example is wide, the WIDE argument is specified not only 
for the <EXAMPLE_ATTRIBUTES> tag, but also for the <CODE_EXAMPLE> 
tag within the example. 


<EXAMPLE_ATTRIBUTES> 


<EXAMPLE> (Command Procedure for Adding a User\adduserex) 
<EXAMPLE_ATTRIBUTES> (MULTIPAGE\WIDE) 
<CODE_EXAMPLE> (WIDE) 


$ ! 

$! ADDUSER.COM -- Adds a new user to the system authorization file 
$ ! 

$ USERDISK = "WRKDS:" ! Default disk for new users 


$ UAF = "SAUTHORIZE" 

<VALID_BREAK> 

ON CONTROLY THEN GOTO CLEANUP 

ON WARNING THEN GOTO CLEANUP 

OLDDIR = FS$LOGICAL("SYS$DISK") + FSDIRECTORY ()’ 
PREVPRIV = FSSETPRV("SYSPRV") 

IF .NOT. FSPRIVILEGE ("SYSPRV") THEN GOTO NOPRIV 
SET DEFAULT SYSSSYSTEM 

i) 


! Request account information 

1 

INQUIRE USERNAME "Username" 

INQUIRE FULLNAME "Full name" 

SET TERMINAL/NOECHO 

INQUIRE PASSWORD "Password [’’Username’]" 
SET TERMINAL/ECHO 


IF PASSWORD .EQS. "" THEN PASSWORD = USERNAME 
GET GRP: 

INQUIRE GRP "UIC Group Number" 

IF GRP .EQS. "" THEN GRP = "*" 


WRITE SYSSOUTPUT "" 

WRITE SYSSOUTPUT "Determine the UIC from the following listing:" 
WRITE SYSSOUTPUT "" 

UAE SHOW [’GRP’,*]/BRIEF 

INQUIRE UIC 


IF UIC .EQS. "" THEN GOTO GET_GRP 
IF FSLOCATE("{",UIC) .EQ. FSLENGTH(UIC) .AND. - 
FSLOCATE("<",UIC) .EQ. FSLENGTH(UIC) THEN UIC = "{" + UIC + "J" 
INQUIRE ACCOUNT "Account Name [VMS]" 
IF ACCOUNT .EQS. "" THEN ACCOUNT = "VMS" 
INQUIRE PRIVS "Privileges [NONE]" 
IF PRIVS .NES. "" THEN PRIVS = "/PRIV=(" + PRIVS + ")" 


USERDIR = FSEXTRACT (0, 9, USERNAME) 
INQUIRE TMP "Login Directory [’’USERDIR’]" 


TMM MNMOMNMNMNOMMMUM MH DMNA MMNAMNNAMONNMNMNONHNNMNUNUNNUHUNUND 


IF TMP .NES. "" THEN USERDIR = TMP 
INQUIRE TMP "Login Device [’’USERDISK’]" 
IF TMP .NES. “" THEN USERDISK = TMP 
DQUOTA = 0 
IF FSSHARCH("!’USERDISK’ [0,0]QUOTA.SYS") .EQS. "" THEN GOTO NQO 
DQUOTA = 1 

<VALID_BREAK> 

§ ! 

$ !} Restore prior working environment 

S$! 

SCLEANUP : 


$ SET TERMINAL/ECHO 

$ PREVPRIV = FSSETPRV (PREVPRIV) 

$ SET DEFAULT ’OLDDIR’ 

$ EXIT 

$ ! 

$ ! In case proper privileges are not set 
wal 

sSNOPRIV: 

$ WRITE SYSSOUTPUT "You need SETPRV or SYSPRV privilege to run this procedure" 
$ GOTO CLEANUP 

<ENDCODE_EXAMPLE> 

<ENDEXAMP LE> 


This example produces the following output: 
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<EXAMPLE_ATTRIBUTES> 


Example n—n Command Procedure for Adding a User 





] 

! ADDUSER.COM -~ Adds a new user to the system authorization file 
1 

USERDISK = "WRKDS:" ! Default disk for new users 
UAF = "SAUTHORIZE" 

ON CONTROLY THEN GOTO CLEANUP 

ON WARNING THEN GOTO CLEANUP 

OLDDIR = FSLOGICAL("SYSS$DISK") + FSDIRECTORY ()’ 

PREVPRIV = FSSETPRV("SYSPRV") 

IF .NOT. FSPRIVILEGE ("SYSPRV") THEN GOTO NOPRIV 

SET DEFAULT SYSSSYSTEM 

! 

y Request account information 

t 

INQUIRE USERNAME "Username" 

INQUIRE FULLNAME "Full name" 

SET TERMINAL/NOECHO 

INQUIRE PASSWORD "Password [’’Username’]" 

SET TERMINAL/ECHO 


IF PASSWORD .EQS. "" THEN PASSWORD = USERNAME 
GET_GRP: 

INQUIRE GRP "UIC Group Number" 

IF GRP .EQS. "" THEN GRP = "*" 


WRITE SYSSOUTPUT "" 

WRITE SYSSOUTPUT "Determine the UIC from the following listing:" 
WRITE SYSSOUTPUT "" 

UAF SHOW [’GRP’,*]/BRIEF 

INQUIRE UIC 


DANN MMMUM NNN NUMNNMNUAUAUAUNUUNHUNUMNAUHHUUNUNUNNMNMUNN 


IF UIC .EQS. "" THEN GOTO GET_GRP 
IF FSLOCATE("{",UIC) .EQ. FSLENGTH(UIC) .AND. - 
FSLOCATE ("<",UIC) .EQ. FSLENGTH(UIC) THEN UIC = "{" + UIC + "]" 

$ INQUIRE ACCOUNT "Account Name [VMS]" 
$ IF ACCOUNT .EQS. "" THEN ACCOUNT = "vms" 
$ INQUIRE PRIVS "Privileges [NONE]" 
$ IF PRIVS .NES. "" THEN PRIVS = "/PRIV=(" + PRIVS + ")" 
$ USERDIR = FSEXTRACT (0, 9, USERNAME) 
$ INQUIRE TMP "Login Directory [’’USERDIR’]" 
$ IF TMP .NES. "" THEN USERDIR = TMP 
$ INQUIRE TMP "Login Device [’’USERDISK’]" 
$ IF TMP .NES. "" THEN USERDISK = TMP 
$ DQUOTA = 0 
$ IF FSSEARCH("’’USERDISK’ [0,0]QUOTA.SYS") .EQS. "" THEN GOTO NQO 
$ DQUOTA = 1 
oo 
$ ! Restore prior working environment 
$! 
SCLEANUP : 


$ SET TERMINAL/ECHO 

$ PREVPRIV = FSSETPRV (PREVPRIV) 

$ SET DEFAULT ‘’OLDDIR’ 

$ EXIT 

$! 

$ ! In case proper privileges are not set 

$ ! 

SNOPRIV: 

$ WRITE SYSSOUTPUT "You need SETPRV or SYSPRV privilege to run this procedure" 
$ GOTO CLEANUP 
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<EXAMPLE_FILE> 


<EXAMPLE FILE> 


Causes a separate file containing an example to be included in the source file. 





SYNTAX <EXAMPLE_FILE>(file spec) 





ARGUMENTS _ file spec 
Specifies the file containing the example. The file can be a logical name. 
See the <INCLUDES_FILE> tag description for information on how to define a 
logical name. 





related tags ° <EXAMPLE> 
¢ <EXAMPLE_ATTRIBUTES> 


© <EXAMPLE_SPACE> 
© <REFERENCE> 





restrictions Valid only in the context of an <EXAMPLE> tag. 





DESCRIPTION _ The <EXAMPLE_FILE> tag causes a separate file containing an example to 
| be included in the source file. 


The included file should be an SDML file containing a complete coded 
example, perhaps using <CODE_EXAMPLE> or <INTERACTIVE> tags. If the 
<EXAMPLE> tag specifies the WIDE argument, the included file must 
specify the WIDE argument in the appropriate tags. For more information 
on correctly coding examples and example files, see VAX DOCUMENT 
Producing Online and Printed Documentation. 


You can give the <EXAMPLE_FILE> tag a logical name for an argument. 
Define the logical name by first entering an <INCLUDES_FILE> tag in the 
profile. The information in that tag is used to make the proper logical 
name assignment during processing. 


EXAMPLE See the example in the discussion of the <EXAMPLE> tag. 
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<EXAMPLE_SPACE> 


<EXAMPLE SPACE> 


Leaves space for an example to be pasted in during final production. 





SYNTAX . value 
<EXAMPLE_SPACE>(| Pa pace [\ text]) 


ARGUMENTS __ value 
Specifies the size of the space in picas, a scale used by typesetters. There 
are approximately 6 picas in an inch (and 12 points in a pica). Thus, if — 
the example is 4 inches high, you should specify 24 picas. The value must 
not exceed page length limitations for the current doctype. If you omit the 
value, a default value of 2 picas is used. 


FULL _PAGE 

This keyword specifies that a full blank page be reserved for the example. 
For Bookreader output, a small amount (smaller than a printed page or a 
Bookreader page) of blank space is left. 


text 

This is an optional argument. It specifies the text to be printed in the 
center of the space. (For example, an art file number, a file name that 
contains the example, or some other note.) 








related tags ° <EXAMPLE> 
° <EXAMPLE_ATTRIBUTES> 


e  <EXAMPLE_FILE> 
¢ <REFERENCE> 





restrictions Valid only in the context of an <EXAMPLE> tag. 


The value argument must not exceed page length limitations. 


DESCRIPTION _ The <EXAMPLE_SPACE> tag, leaves space for an example to be pasted in 
during final production. Any text you supply as the second argument is 
printed in the center of the space. 


EXAMPLE This example shows how to use the <EXAMPLE_SPACE> tag. 


<EXAMPLE> (Completing Form DD-214\annotated_dd214_ exam) 

<EXAMPLE ATTRIBUTES> (wide) 

<EXAMPLE SPACE>(12\Photo-reduced copy of the end of DD-214 here.) 
<ENDEXAMP LE> 


This example produces the following output: 


<EXAMPLE_SPACE> 


Example n-n Completing Form DD-214 
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<FCMD> 


<FCMD> 


Specifies the keyword portion of a command/parameter pair in a format 
section. 








SYNTAX <FCMD> (keyword [\ parameters]) 
ARGUMENTS keyword 
Specifies the keyword portion of the command/parameter pair. 
Par ameters 


related tags 


restrictions 


This is an optional argument. It specifies the command parameters, if any. 


Parameters specified in this argument differ in your output from 
arguments specified using the <FPARMS> tag. If you do specify the <FCMD> 
tag with a null second argument, it is reeommended that you explicitly 
declare the absence of parameters using the <FPARMS> tag, as follows: 


<FCMD> (KEYWORD) <FPARMS> () 


If you do not specify a second argument, and if the <FPARMS> tag is not 
specified, the tag translator issues a warning message that it has no 
explicit declaration of parameters. 





°¢ <FORMAT> 
¢ <FPARM> 
¢ <FPARMS> 





Valid only in the context of a <FORMAT> tag. 


DESCRIPTION 
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The <FCMD>tag specifies the keyword portion of a command/parameter pair 
in a format section. You can specify the keyword’s argument list as the 
second argument to this tag. The <FCMD>tag should be used only in the 
context of a format section. A format section is established by <FORMAT> 
and <ENDFORMAT> tags. 


If the text of the parameters argument does not fit on one line, the text 
formatter chooses suitable line breaks based on the presence of spaces. 


<FCMD> 





EXAMPLES The following example specifies a single command keyword. The <FPARMS> 
tag is explicitly specified as null. The output that this example produces is 
shown in Output Sample 1. 


| <FORMAT> 
<FCMD> (exit) <FPARMS> () 
<ENDFORMAT> 


The following example specifies the command keyword and its parameters 
using both the <FCMD> and <FPARMS> tags. The output that this example 
produces is shown in Output Sample 2. 


<FORMAT> 
<FCMD> (append) <FPARMS>(input-file-spec output-file-spec) 


<ENDFORMAT 
The following example specifies both the keyword and the parameters 
arguments to the <FCMD> tag. The output that this example produces is 
shown in Output Sample 3. 
Notice the difference between Output Sample 2 and 3. In Sample 2, space 
is left between the keyword and the parameters. In Sample 3, no space is 
left. The formatting is produced by the syntax used in the <FCMD> tag. 
<FORMAT> 
<FCMD> (f$element\ (element-number, delimiter, string) ) 
<ENDFORMAT 


The following example shows how to control the interpretation of 
keywords tagged with the <KEYWORD> tag when they are mixed in with 
the parameters of a format specification. The output that this example 
produces is shown in Output Sample 4. 


<FORMAT> 
<FCMD>(set protection\ [=code] <keyword> (/DEFAULT) ) 


<ENDFORMAT 
The following example specifies the command keyword and its parameters 
using the <FCMD>, <FPARMS>, and <FPARM> tags. The output that this 
example produces is shown in Output Sample 5. 
<FORMAT> 
<FCMD> (append) <FPARMS>(one parameter) <FPARM>(two parameters) <FPARM>(three parameters) 
<ENDFORMAT 


OUTPUT exit 

SAMPLE 1 

a ee a a a aS 
OUTPUT append input-file-spec output-file-spec 

SAMPLE 2 
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<FCMD> 











OUTPUT f$element (e/ement-number, delimiter, string) 
SAMPLE 3 

OUTPUT set protection/=code//DEFAULT 

SAMPLE 4 

OUTPUT append one parameter 

SAMPLE 5 two parameters 


three parameters 
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<FIGURE> 





<FIGURE> 


Labels the beginning of a figure. 





FORMAT 


<FIGURE>/(figure caption[\ symbol name])] 





ARGUMENTS 


related tags 


restrictions 


required 
terminator 


figure caption 

This is an optional argument. It specifies the text of the caption to be 
associated with the figure. The figure caption and the associated figure 
number will be included in the table of contents for the document. If the 
body of the figure spans more than a single page of text, the figure caption 
is repeated on each page on which the figure continues. 


symbol name 

This is an optional argument. It specifies the symbolic identifier to be 
associated with the example. The symbol name is assigned a numeric 
value, which becomes the current figure number. The symbol name and its 
value are placed in the symbol table. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores in them. Do not begin a 
symbol name with an underscore. 





¢ <FIGURE_ATTRIBUTES> 
¢ <FIGURE_FILE> 

¢ <FIGURE_SPACE> 

¢  <ICON> 

¢ . <ICON_FILE> 

e = =6.<LINE_ART> 


<REFERENCE> 





Invalid in the context of a <FOOTNOTE> tag. 





<ENDFIGURE> 


DESCRIPTION 


The <FIGURE> tag labels the beginning of a figure. A formal figure has a 
number and a caption, can be cross-referenced, and is listed in the table 
of contents. An informal figure does not have a number or a caption, 
cannot be cross-referenced, and is not listed in the table of contents. 
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<FIGURE> 


A formal figure is sometimes long. If you think one of your figures 
will be longer than a page, label it as a multipage figure in the 
<FIGURE_ATTRIBUTES> tag. See the <FIGURE_ATTRIBUTES> tag description 
for more information. 


Note the following when processing a book for Bookreader display: 


¢ You must use the symbol name argument to process a formal figure for 
Bookreader display. 


¢ DOCUMENT automatically creates pop-up windows for all formal 
figures. 

¢ When introducing and cross-referencing a formal figure, you must use 
the <REFERENCE> tag to create a hotspot. Hotspots are regions in 
the windows you click on with your mouse to access cross-referenced 
topics. 

¢ You can use the <ONLINE_POPUP> tag if you want to make informal 
figures pop up. 


When you print an informal or formal figure, or process an informal] figure 
for Bookreader display, the figure is indented in the same way the regular 
text is for the particular doctype you are using. 





EXAMPLES In the following example, the <FIGURE_ATTRIBUTES> tag contains a KEEP 
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argument, to specify that the figure should be kept with the immediately 
preceding text. The <LINE_ART> tag also has a KEEP argument, to specify 
that the figure should not break across pages. 


The figures you are able to create using your terminal keyboard may be 
adequate for draft purposes, but may not be acceptable in the context of 
typeset output. 

<FIGURE> (Example of Terminal-Created Art\transfer_vector_exam) 


<FIGURE_ATTRIBUTES> (KEEP) 
<LINE_ART> (KEEP) 


Shareable Image Executable Image 
perenne nn--~ + S eatahatetebetatatabeted + 
+----| Vector A |<------- + i | 

ne Sree + | | : | 
| t--| Vector B |[<---+ +----- Invoke A | 
Lili Seeeeeeoee ner + | | | 
5 daar | : | 
| | Routine A | +--------- Invoke B | 

1 | | . | 
1 epee ee a | : | 
+->| | S oeatestestestentetenteateatedeten + 


<ENDLINE_ART> 
<ENDFIGURE> 


This example produces the following output: 


<FIGURE> 


Figure n-n Example of Terminal-Created Art 





Shareable Image Executable Image 
focccc nce + S alatatetatatatetatetetes + 
+t-~---| Vector A |[<------- + | | 
| Pres ssSaecse + | | : | 
| +--{ Vector Bo |<---t 9 tm--~- Invoke A | 
[ails . Sees een om + | | : | 
peer? | | | | . | 
| | Routine A | teecccnnn= Invoke B | 
1 | | | | 
hb. ete Seee seer + | 
+->| | tenn n renner n= + 





The following example shows how to code a figure that is allowed to 
extend over several pages. The MULTIPAGE argument to the <FIGURE_ 
ATTRIBUTES> tag tells the text formatter that the figure is more than one 
page. Note that the text formatter does not break a large figure and adjust 
its portions on multiple pages; rather, MULTIPAGE indicates that the 
text formatter outputs the text, “Cont’d on next page”, to indicate that the 
figuré continues. The figure that you create should fit on one page. If it 
does not, the remainder of the figure does not print, but the text, “Contd 
on next page” still appears. For Bookreader output, the words “Cont’d on 
next page” do not appear. 


<FIGURE>(Digital Multinational Character Set\char_set_fig) 
<FIGURE_ATTRIBUTES> (Multipage) 
<FIGURE_FILE>(LNO3\character_set.SIX\27) 

<FIGURE . FILE> (PS\character_ set.PS\27) 

<FIGURE ._ FILE> (BOOKREADER\character__ set .BRF\54) 

<FIGURE  FILE> (LNO3\character_ set2.SIX\27) 

<FIGURE | FILE> (PS\character_ set2.PS\27) 

<FIGURE __FILE> (BOOKREADER\character__ set2.BRF\54) 


This example produces the following output: 


<FIGURE> 


Digital Multinational Character Set 


Figure n—n 
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Figure n—n (continued on next page) 
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<FIGURE> 


Figure n—n (Cont.) Digital Multinational Character Set 
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CR Codes 
be—— 1 Codes ——e}q————————————-— (DEC Supplemental Graphic) ———__—_—_—+ 





The following example shows how to code an informal figure that appears 
within text without floating, without a number, and without a caption. 


<P> A VT200 is different from a VT300 terminal. 
The following figures illustrate an obvious difference in hardware between 
the two types of terminals. 


<FIGURE_FILE>(LNO3\VT_Terminals.SIX\21) 
<FIGURE_FILE>(PS\VT_Terminals.PS\21) 
<FIGURE_FILE>(BOOKREADER\VT_Terminals.BRF\21) 
<ENDFIGURE> 


The first figure shows that ... 


This example produces the following output: 
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<FIGURE> 


A VT200 is different from a VT300 terminal. The following figures 
illustrate an obvious difference in hardware between the two types of 
terminals. 
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The first figure shows that... 
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<FIGURE_ATTRIBUTES> 


<FIGURE_ATTRIBUTES> 


Specifies the placement of a figure on the page. 





FORMAT FLOAT 
<FIGURE_ATTRIBUTES>() KEEP [\ WIDE}) 


MULTIPAGE 





ARGUMENTS FLOAT 
This keyword specifies whether the location of a one-page figure is allowed 
to float if there is not enough room on the current page for the figure. 
FLOAT instructs the text processor to fill the current page with the text 
from the source file that follows the <FIGURE> tag sequence, and to place 
the figure at the top of the next page of output. 


Float is the default for a figure that has a caption and does not specify 
MULTIPAGE or KEEP. FLOAT has no effect for Bookreader output. 


KEEP 

This keyword specifies that the figure be kept with the immediately 
preceding text. This is the default for a figure without a caption. KEEP 
has no effect for Bookreader output. 


MULTIPAGE 


This keyword specifies that the figure has multiple elements, and that 
each element is allowed to break at the start of a new page. This 
argument is required if the figure elements require more than one page. 
When a figure is continued, the figure caption and figure column heads, 
if any, are automatically repeated at the beginning of each new page of 
output. MULTIPAGE has no effect for Bookreader output. 


WIDE 

This is an optional keyword argument. It specifies that the width of the 
figure exceeds the document’s default width for text. You can use WIDE 
with FLOAT, KEEP, or MULTIPAGE, or you can use WIDE as the only 
argument. Depending on the doctype, this argument is interpreted as 
follows: 


e Ifthe doctype contains a left margin area that is normally used for 
headings, the figure’s width spans that area as well as the normal text 
area. 


e Ifthe document uses a multicolumn format, the figure suspends 
multicolumn output while the figure is processed. The figure is output 
across two columns and then multicolumn output is restored. 


¢ Depending on the doctype, this argument provides a range of font sizes 
and font styles for figures. 


Note: If you use a <FIGURE_ATTRIBUTES> tag and specify the WIDE 
argument to that tag, which makes the caption align at the 
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<FIGURE_ATTRIBUTES> 


related tags 


restrictions 


leftmost position of the image area, you still must use the WIDE 
argument to the <FIGURE_FILE> tag to align the figure itself at the 
leftmost position of the image area. 





e <FIGURE> 
e <FIGURE_FILE> 
e <FIGURE_SPACE> 





Valid only in the context of a <FIGURE> tag. 





DESCRIPTION 


The <FIGURE_ATTRIBUTES> tag specifies the placement of a figure on 

the page. Use the tag in the context of a formal figure to adjust the 
pagination and placement of the figure. See the <FIGURE> tag description 
for more information about formal and informal figures. 


If the figure is formal and you need a wide caption that extends into the 
leftmost position of the image area, use the WIDE argument. You still 
must use the WIDE argument to the <FIGURE_FILE> tag to align the figure 
itself at the leftmost position of the image area. 


A formal figure is sometimes long. If you think one of your figures will be 
longer than a page, use the MULTIPAGE argument. Your figure will then 
be placed on the current page and continued on following pages, as space 

permits. 


A multipage figure can contain one or more elements (that is, one or more 
<FIGURE_FILE>, <FIGURE_SPACE>, and <CODE_EXAMPLE> tags). 


If your multipage figure (consisting of a single <CODE_EXAMPLE>) contains 
no blank lines, you might want to insert <VALID_BREAK> tags in the figure. 
The <VALID_BREAK> tags specify reasonable page breaking points. See the 
description of the <VALID_BREAK> tag for more information. 


A one-page (or smaller) formal figure’s position in the output file can 
change. If the figure does not completely fit on the current page, the 
entire figure is placed at the top of the next page. The text that follows 
the example in the SDML file then is used to fill the current output 
page. When the figure’s position can change, the figure is said to float. 
Formal figures that float, then, may appear out of place. Use the <FIGURE_ 
ATTRIBUTES>(KEEP) tag to force the figure to be kept with the text that 
immediately precedes it. . 


Floating is the default for a formal figure that fits on one page. If you 
want an informal figure to float, you must specify the FLOAT argument if 
your figure fits on one page. A multipage figure never floats. 


EXAMPLE 
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See the examples in the discussion of the <FIGURE> tag. 


<FIGURE_FILE> 


<FIGURE_FILE> 


Includes a graphics file in your output file if the output device has graphics 





capability. 
FORMAT \ file spec 
<FIGURE_FILE> (target device { | ile spec | 
\ vertical size 
| FULL_PAGE \ Wairaelt 





ARGUMENTS #_ farget device 
Specifies a keyword indicating the output device for the graphics 
file. Keywords are provided both for devices that do (LN03, PS, and 
Bookreader) and do not (LINE, MAIL, and TERMINAL) support graphics. 
Each keyword allows you to insert the necessary amount of white space 
for the specific output device; keywords for devices that do not support 
graphics allow you to insert blank space in place of a figure. The following 
table lists the output devices and expected output for each keyword. 


Keyword Device Output 

BOOKREADER DECwindows screen The specified graphics file is output 
online using Bookreader. 

LNO3 LNO3 Laser Printer The specified sixel graphics file is 
output as a figure. 

PS PRINTSERVER 40 or The specified PostScript graphics 

LNO3R ScriptPRINTER file' is output as a figure. 

LINE Line Printer If specified, blank space is output 

MAIL with the file spec argument written 

TERMINAL in that blank space. Use only one 


of these three keywords to indicate 
a monospaced destination. 


'PostScaiet graphics files must conform to the Encapsulated PostScript File Format 
published by Adobe Systems, Inc. 


If you specify the <FIGURE_FILE> tag for a given device and subsequently 
process the file on another output device, no output will appear in the 
position of the <FIGURE_FILE> tag. 


file spec 
Specifies the graphics file. 
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<FIGURE_FILE> 


related tags 


restrictions 
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Note: 


SPACE 

This keyword lets you reserve blank space in the output file for a figure. 
You can use it if you do not use the file spec argument. Use SPACE to 
reserve space for art that will be pasted in at a later date or when you 
expect to process a file for more than one output device, but do not have 
graphics files for all devices. 


vertical size 

Specifies the vertical size of the printed graphic in picas (6 picas equal an 
inch, and 12 points equal a pica). This argument may be a nonnegative 
integer or decimal number, including zero. 


FULL_PAGE 
You can use FULL_PAGE if you do not use the vertical size argument. It 
specifies that a full blank page be reserved for the figure. For Bookreader 
output, a small amount (smaller than a printed page or a Bookreader 
page) of blank space is left. 


WIDE 


This is an optional keyword argument. If you use it, it must come last 
in the argument list. WIDE specifies that the graphic be aligned at the 
leftmost position of the image area (if your doctype uses a wide left gutter). 


If you use a <FIGURE_FILE> tag and specify the WIDE argument 

to that tag, which makes the figure itself align at the leftmost 
position of the image area, you still must use the WIDE argument 
to the <FIGURE_ATTRIBUTES> tag to align the caption at the leftmost 
position of the image area. 





¢ <FIGURE> 

¢ <FIGURE_ATTRIBUTES> 

° <ICON> 

¢  <ICON_FILE> 

¢ = ©<LINE_ART> 

¢ <REFERENCE> 

¢ <SET_FIGURE_FILE_SPACING_DEFAULT> 





Valid only in the context of a <FIGURE> tag. 


You must use an LN03 or POSTSCRIPT laser printer to print graphics files 
or use Bookreader to view graphics files online. 


If you use the <FIGURE_FILE> tag in a file that you process for multiple 
output devices, you must supply a tag for each device, using the SPACE 
argument for devices for which you do not have graphics. 


<FIGURE_FILE> 


DESCRIPTION 


The <FIGURE_FILE> tag includes a graphics file in your output file if the 
output device has graphics capability. 


To ensure that your figure is the right size for inclusion with your output, 
follow this procedure: 


1 Create and print your graphics file full size (100 percent). 
2 Measure it. 


3 Ifthe figure at 100 percent is the desired size and will fit on the page, 
incorporate that measurement into the <FIGURE_FILE> tag. Otherwise, 
use the Graphics Editor to reduce the figure to the desired size. 


4 Process the SDML file that the Graphics Editor produces and print the 
output. See the VAX DOCUMENT Graphics Editor User’s Guide for 
information on using the Graphics Editor. 


5 Evaluate the result. If it is not satisfactory, change either of the 
following: 


¢ One or both keywords specified in the <FIGURE_FILE> tag to correct 
the alignment, spacing, or both, for the figure 


e The graphics file itself to correct the size, content, or both 


Because there is an interaction between changing the contents or size of 
the graphics file and specifying its placement in the <FIGURE_FILE> tag, 
satisfactory results may require several loops through the process, much 
like coding complicated tables. Refer to VAX DOCUMENT Producing 
Online and Printed Documentation for information on coding tables. 


If you plan to process your file for more than a single destination, you can 
use multiple <FIGURE_FILE> tags to ensure that the appropriate figure will 
be included for the appropriate destination; an example of this coding is 
given in the following section. If you use multiple <FIGURE_FILE> tags in 
this way, you should specify only a single <FIGURE_FILE> tag for all the 
monospaced destination keywords (MAIL, TERMINAL, or LINE). 





EXAMPLES 


The following example shows how to code a captioned, numbered figure. 
The figure would appear in the table of contents. 


<FIGURE> (The Front View) 
<FIGURE_FILE>(LN03\Frontpanel .SIX\6) 


<ENDFIGURE> 


The following example shows how to code an uncaptioned, unnumbered 
figure. The figure would not appear in the table of contents. 
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<FIGURE_FILE> 
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<FIGURE> 
<FIGURE_FILE>(LNO3\Example Figure.PS\10) 
<ENDFIGURE> 


The following example shows how to use multiple <FIGURE_FILE> tags so 
that your figure will process for multiple destinations. If you process this 
file for a POSTSCRIPT destination, the file included is DOG_TRAINING.PS. 
If you process this file for an LN0O3 laser printer destination, the file 
included is DOG_TRAINING.SIX. If you process this file for a line printer 
destination, no file is included; instead, 10 blank lines are reserved for 
the graphic. If you process this file for Bookreader, the file included is 
DOG_TRAINING.BRF. 


<FIGURE> 
<FIGURE_FILE>(LNO3\Dog_Training.SIX\10) 
<FIGURE_FILE>(PS\Dog_ Training.PS\10) 
<FIGURE_FILE> (LINE\SPACE\10) 
<FIGURE_FILE>(BOOKREADER\Dog_Training.BRF\10) 
<ENDFIGURE> 


This example produces the following output: 


aN 


— 
» hy 
Ae) Jf 


sitting dog 
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<FIGURE_SPACE> 





<FIGURE_SPACE> 


Marks the space required for a figure that will be pasted in during final 
production. 





FORMAT | value 
<FIGURE_SPACE>(| Spree Mn text) 


ARGUMENTS _ value | 
Specifies the amount of vertical space to be left on the page. Specify the 
value in picas, a scale used by typesetters. There are 6 picas in an inch 
(and 12 points in a pica). Thus, if the figure to be pasted in is 4 inches 
high, you should specify 24. If you do not specify a value, a default value 
of 2 is used. 


FULL_PAGE 

This keyword specifies that a full blank page be reserved for the figure 

if you do not use the value argument. For Bookreader output, a small 
amount (smaller than a printed page or a Bookreader page) of blank space 
is left. 


text | 

This is an optional argument. It specifies the text that describes the 
status of the figure, an art file number, or the words “To Be Set.” The text 
is output in the middle of the space left for the figure. 








related tags ° <FIGURE> 
¢ <FIGURE_ATTRIBUTES> 


¢ <FIGURE_FILE> 
¢ <FIGURE_SPACE> 
e =6©<<LINE_ART> 

¢ <REFERENCE> 





restrictions Valid only in the context of a <FIGURE> tag. 


The value argument must not exceed page length limitations. 


DESCRIPTION _ The <FIGURE_SPACE> tag marks the space required for a figure that will be 
pasted in during final production. 


If you specify some descriptive text in the second argument, that text is 
output in the middle of the space left for the figure. 
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<FIGURE_SPACE> 





EXAMPLES The following example shows how to leave space for a figure that is 18 
picas long. Notice that 18 picas (or 3 inches or 216 points) of space are left 
for the figure. 

| <FIGURE> (Illustration of a Computer Terminal\terminal_fig) 

<FIGURE_SPACE>(18\An illustration of a computer terminal.) 
<ENDFIGURE> 


This example produces the following output: 


Figure n—n_ Illustration of a Computer Terminal 


An illustration of a computer terminal. 


The following example shows how to leave space for a figure that will take 
one page. 


2 <FIGURE> (Illustration of a Garage\garage_fig) 
<FIGURE_SPACE>(FULL_PAGE\An illustration of a garage.) 
<ENDFIGURE> 


This example produces output like that found on the following page. 
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<FIGURE_SPACE> 


Figure n—n_ Illustration of a Garage 


An illustration of a garage. 


DECLIT AA vax oTB4C 


vax DOCUMENT using giones 


cage 
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<FILE_SPEC> 


<FILE SPEC> 


Allows you to use a file specification that contains angle brackets as an 
argument to a tag without VAX DOCUMENT interpreting that file specification 
as a tag. 





FORMAT 


<FILE_SPEC=>(file specification) 





ARGUMENTS 


related tags 


file specification 
Specifies the file specification that contains angle brackets. 





© <ELEMENT> 

e¢ <EXAMPLE_FILE> 
e¢ <FIGURE_FILE> 

¢ <ICON_FILE> 

¢ <INCLUDE> 

¢ <INCLUDES_FILE> 
® <TABLE_FILE> 





DESCRIPTION 


The <FILE_SPEC> tag allows you to use a file specification that contains 
angle brackets as an argument to a tag that lets you include external files 
without VAX DOCUMENT interpreting that file specification as a tag. 

A complete list of tags that let you include external files is found in the 
“Related Tags” section of this tag description. 


Some keyboards do not provide square brackets, ([) and (]), so it is common 
for the directory portion of a file specification to be delimited by angle 
brackets. Because VAX DOCUMENT would normally interpret text within 
angle brackets as an SDML tag, the <FILE_SPEC> tag converts any angle 
brackets in its argument into the corresponding square brackets. 


You do not have to use the <FILE_SPEC> tag to specify logical names in a 
file specification whose equivalence strings contain angle brackets. 





EXAMPLE 


The following example shows how to use the <FILE_SPEC> tag. 


<figure_file>(1n03\<file_spec>(mydisk:<figure>diagram. six) \20) 
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<FILE SPEC> 


The directory name in this file specification would normally be seen as 
a <FIGURE> tag, which would lead to erroneous results. Because the file 
specification is used as an argument to the <FILE_SPEC> tag, the angle 
brackets are converted to square brackets before the apparent <FIGURE> 
tag is recognized. Thus, the example is equivalent to the following: 


<figure_file>(1n03\mydisk: [figure] diagram.six\20) 
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<FINAL_CLEANUP> 


<FINAL_CLEANUP> 


Provides explicit formatting instructions to the text formatter to be used for 
final formatting and clean up. 





FORMAT COLUMN_BREAK 


<FINAL_CLEANUP>( rag tint ) 


SPECIAL_BREAK 





ARGUMENTS COLUMN_BREAK 
Specifies that a new column of text be started at the place where the 
<FINAL_CLEANUP> tag occurs. This argument is only valid in a two-column 
doctype: the ARTICLE or REPORT.TWOCOL doctypes, described in VAX 
DOCUMENT Using Doctypes and Related Tags. 


LINE_BREAK 


Specifies that the following text begin a new line of output. 


PAGE_BREAK 


Specifies that the following text begin a new page of output. 


SPECIAL_BREAK 


Specifies a special break when vertical spacing appears to be lost. In some 
circumstances, the output of a two-column page may have had some of 
its vertical spacing lost due to the text formatter processing; for example, 
a heading tag may not have any space before it. You can correct this by 
placing the <FINAL_CLEANUP>(SPECIAL_BREAK) tag in your file between the 
words that are ouput on the final line of the first column. 


Use the SPECIAL_BREAK argument only if there is a spacing problem 
and only after you are ready to give your document a final format check, 
because changes to the source file may help the text formatter resolve the 
spacing problem. 








related tags ¢ <COLUMN> — In the ARTICLE and REPORT.TWOCOL doctypes, 
described in VAX DOCUMENT Using Doctypes and Related Tags. 
e 6<LINE> 
¢ <PAGE> 
restrictions Should be used only for final production formatting. 


If you use the <FINAL_CLEANUP>(PAGE_BREAK) tag in a table to force a page 
break, the table headings are not repeated on the page after the break. 
You must repeat the <TABLE_HEADS> tag immediately after the <FINAL_ 
CLEANUP>(PAGE_BREAK) tag to restore the default table headings. Headings 
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<FINAL_CLEANUP> 


are repeated on each page of a table only when DOCUMENT is allowed to 
break the table across pages. 


In doctypes with right-justified text (that is, text aligned against the 
right margin), the <FINAL_CLEANUP>(LINE_BREAK) tag must be on the same 
line of the text you want broken. 


DESCRIPTION 


The <FINAL_CLEANUP> tag provides explicit formatting instructions to the 
text formatter to be used for final formatting and clean up. The <FINAL_ 
CLEANUP> tag is not a generic markup tag; it explicitly instructs the text 
formatter to change aspects of the page makeup. 


In a single-column doctype, the <FINAL_CLEANUP> tag enables you to 
specify line breaks and page breaks using the LINE_BREAK and PAGE_ 
BREAK arguments. In a two-column doctype, you can use the COLUMN_ 
BREAK argument to start a new column of text. Use the SPECIAL_ 
BREAK argument only rarely at the final stage of production to affect the 
final format of your document. 


When you are working with the ARTICLE or REPORT.TWOCOL doctypes, 
you may need to make some final adjustments when your text is complete. 
The text formatter makes formatting decisions based on your source — 
file. It is more difficult for the text formatter to create a well-formatted 
two-column page than a well-formatted one-column page. Therefore, the 
output of these doctypes may need additional attention, using the <FINAL_ 
CLEANUP> tag, during the last stage of production. 


Using the <FINAL_CLEANUP> tag has no effect for Bookreader output. 


EXAMPLES 


The following example shows how final production might use the <FINAL_ 
CLEANUP>(LINE_BREAK) tag in the front matter of a book to make it look 
better. 


1 <FRONT_ MATTER> (front) 


<REVISION_INFO>(Revision/Update Information:\This revised manual 


supersedes 


the <final_cleanup>(line_ break) <emphasis>(VAX DOCUMENT User Manual, Volume 1 Version 1.1) 
<oparen>Order Number AA~-JT84B--TE<cparen>.) 
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<FINAL_CLEANUP> 


The following example shows how final production might use the <FINAL_ 
CLEANUP>(PAGE_BREAK) tag, because the information in these specific 
headings might look better or fit better on separate pages. 


2 <HEAD1> (Survey Results) 


<FINAL CLEANUP> (page_break) 
<HEAD2>(Brand X) 
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<FOOTNOTE> 


<FOOTNOTE> 


Creates a footnote in text and tables. In text, this tag specifies the footnote 
character and footnote text, and places the footnote text at the bottom of 

the page or in a pop-up window for Bookreader output. In a table, this tag 
specifies the footnote character and footnote text; the <FOOTREF> tag outputs 
the footnote character. Footnotes in tables appear at the bottom of the table. 





FORMA 


<FOOTNOTE> (char \ footnote text) 





ARGUMENTS 


related tags 


restrictions 


char | 
Specifies the footnote character. The character can be a single character, 
a number, or one of the following keywords denoting special characters 
associated with footnote references: 


DAG (1) 
DDAG (¢) 
R @) 

S (§) 

TM (™) 


When placing a footnote in a table, you must use a number or one of the 
keywords as the footnote character. 


If you use more than one of the keywords allowed for table footnotes, you 
should declare them in the following order to ensure that the footnotes 
print in the correct order at the bottom of the page or in the pop-up 
window for Bookreader output: 


a Ff OO ND = 
mM 


DDAG 


footnote text 
Specifies the text of the footnote. 





© <FOOTNOTE_TEXT> 
e =6©<FOOTREF> 





Invalid in the context of a <MATH> tag. 
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<FOOTNOTE> 


The following restrictions apply to footnotes in text: 


¢ Do not place the following tags within an argument to the <FOOTNOTE> 
tag: <CODE_EXAMPLE>, <EXAMPLE>, <FIGURE>, <HEADn>, <MATH>, 
<NOTE>, or <TABLE>. 


¢ Do not place more than four footnotes within a stacked list or a 
monospaced example. 


The following restrictions apply to footnotes in a table: 


e Use the <FOOTNOTE> and <FOOTREF> tag combination in a table. It is 
the <FOOTREF> tag that causes the footnote character to appear. Place 
the <FOOTREF> tag in the argument to the <TABLE_ROW> tag at the end 
of the argument you want to footnote. 


¢ Declare all table footnotes at the top of the table using a <FOOTNOTE> 
tag just after the <TABLE_SETUP> tag. Do not specify <FOOTNOTE> tags 
in a nested table. 


¢ Do not specify more than twelve footnotes in a table. If you use a 
nonnumeric footnote character, there can be no more than seven 
numeric footnotes. 


e Footnotes in the body of a multipage table appear at the bottom of a 
page only if they are called out on that page. 


¢ Footnotes called out in the heading of a multipage table appear at the 
bottom of each page of the table. 





DESCRIPTION The <FOOTNOTE> tag creates a footnote in text and tables. In text, this 
tag specifies the footnote character, which appears in the text at the place 
where the tag is located, and footnote text. The footnote text appears at 
the bottom of the page or in a pop-up window for Bookreader output 
(once you click on the superscript footnote reference, which is a hotspot). 
In a table, this tag specifies the footnote character and footnote text; the 
<FOOTREF> tag outputs the footnote character. Footnotes in tables appear 
at the bottom of the table for both printed and Bookreader output. 


For footnotes in a heading, on a copyright page, or on a title page, use the 
<FOOTNOTE_TEXT> and <FOOTREF> tag combination. See the <FOOTNOTE_ 
TEXT> and <FOOTREF> tag descriptions for more information. 


Da hk ee RS 
EXAMPLES The following example shows how to place a footnote in text. 


<P>The <TAG> (footnote) tag produces output that looks like 
this.<FOOTNOTE>(1\Note how 
footnote text appears at the bottom of the page or in a pop-up window for 
Bookreader output.) 
This example produces the following output: 
The <FOOTNOTE> tag produces output that looks like this.1 


The following example shows how to use a footnote in a table. 


1 Note how footnote text appears at the bottom of the page or in a pop-up window for Bookreader output. 
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<TABLE> (Rules for Determining Expression Modes\express_modes_ tab) 


<TABLE ATTRIBUTES> (MULTIPAGE) 

<TABLE SETUP>(2\43) 

<FOOTNOTE>(1\A footnote in a table.) 

<TABLE _HEADS>(Expression\Value Type) 
<TABLE_ROW> (Integer value\Integer) 

<TABLE _ROW> (String value\String<FOOTREF> (1) ) 
<TABLE _ROW> (Integer lexical function\Integer) 
<TABLE _ROW>(String lexical function\String) 
<TABLE_ROW> (Integer symbol1<FOOTREF> (1) \Integer) 
<TABLE _ROW>(String symbol\String) 

<TABLE ROW>(Any value .AND. or .OR. any value\Integer) 
<TABLE _ROW> (Any value\Integer) 

<TABLE_ROW> (Any value\Integer) 

<ENDTABLE> 


This example produces the following output: 


Table n.n Rules for Determining Expression Modes 


Expression 


Integer value 

String value 

Integer lexical function 

String lexical function 

Integer symbol’ 

String symbol 

Any value .AND. or .OR. any value 
Any value 

Any value 


'A footnote in a table. 


<FOOTNOTE> 


Value Type 


Integer 
String! 
Integer 
String 

Integer 
String 

Integer 
Integer 
Integer 


The following example shows how to use the <FOOTNOTE> and <FOOTMEF> 
tags in text to produce multiple references to the same footnote. 


<P>The macro format for a SGETDVI request is:<FOOTNOTE>(1\The 
eighth (last) 
argument is not used; it is reserved for future use.) 
<CODE_EXAMPLE> 
$GETDVI [efn], [chan], [devnam],itmlst, [iosb], [astadr], [astprm] 
<ENDCODE EXAMPLE> 
<P>The high-level language format for a $GETDVI request is:<FOOTREF> (1) 
<CODE_EXAMPLE> 
SYSSGETDVI (fefn], [chan], [devnam] ,itmlst<FOOTREF> (1), [iosb], [astadr], [astprm] ) 
<ENDCODE_EXAMPLE> 


This example produces the following output: 
The macro format for a $GETDVI request is: 
$GETDVI [efn],[chan],[devnam],itmlst,[iosb],[astadr],[astprm] 


The high-level language format for a $GETDVI request is:! 
SYS$GETDV\([efn], [chan], [devnam],itmist! ,[iosb],[astadr],[astprm]) 


1 The eighth (last) argument is not used; it is reserved for future use. 
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<FOOTNOTE_TEXT> 





<FOOTNOTE_ TEXT> 


Specifies the text of a footnote in a heading, copyright page, or title page. 





FORMAT 


<FOOTNOTE_TEXT>(char| text) 





ARGUMENTS 


related tags 


restrictions 


char ; 

Specifies the footnote character. The character can be a single character 
or number, or it can be one of the following keywords denoting special 
characters associated with footnote references: 


DAG (7) 
DDAG (4) 
R ®) 

S (8) 

TM (™) 


text 


Specifies the text associated with the footnote. 





e¢ <FOOTNOTE> 
e @6<FOOTREF> 
e = =6©6<SPECIAL_CHAR> 





Do not use the <FOOTNOTE_TEXT> tag for table footnotes; use the 
<FOOTNOTE> tag. 


Must follow the related <FOOTREF> tag in the source file. 


You must use the <SPECIAL_CHAR> tag to output a special character that 
you want to appear in the text argument to the <FOOTNOTE_TEXT> tag. 


DESCRIPTION 
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The <FOOTNOTE_TEXT> tag specifies the text of a footnote in a heading, 
copyright page, or title page. The footnote text appears at the bottom of 
the page or in a pop-up window for Bookreader output. The <FOOTNOTE_ 
TEXT> tag must follow the <FOOTREF> tag. 


Use the <FOOTREF> tag to output a footnote in the argument to a <HEADn> 
tag and the <COMMAND_SECTION_HEAD> and <SUBCOMMAND_SECTION_HEAD> 
tags of the SOFTWARE doctype, and to output footnotes on a copyright 

page or a title page. In all other cases, you must use the <FOOTNOTE> tag. 


n.n 


n.n 


<FOOTNOTE_TEXT> 


ESR aa a a a a GS RS i ne ne ae 
EXAMPLES The following example shows how you might use a footnote on the title 


page of a document. 


<FRONT_MATTER> 
<TITLE PAGE> 
<TITLE> (Guide to Growing Premium Fruit Bearing Plants) 


<ABSTRACT> (July 1990) 
This document describes how to cultivate LEMON<FOOTREF>(TM) trees. 
<ENDABSTRACT> 


<FOOTNOTE_TEXT>(TM\LEMON is a trademark of Lemon Growers, Inc.) 
<ENDTITLE PAGE> 


The following example shows how to use the <FOOTNOTE_TEXT> and 
<FOOTREF> tags in a heading. 


<HEAD1> (Introduction to The News Today<footref> (TM) ) 
<footnote _text>(TM\The News Today 

is a trademark of the American Television 

Society.) 


This example produces the following output: 





Introduction to The News Today™ 


The following example shows how to use multiple arguments to the 
<FOOTREF> tag and how to use the <SPECIAL_CHAR> tag in footnote text. 


<HEAD1>(Using PostScript<FOOTREF>(1\2) Printers\ps_ printers) 
<FOOTNOTE_TEXT>(1\PostScript <SPECIAL_CHAR>(TRADEMARK_SYMBOL) is a trademark 
of Adobe Systems, Inc.) 

<FOOTNOTE TEXT>(2\For more information about Digital’s printers ... ) 


This example produces the following output: 





Using PostScript! Printers 


™ The News Today is a trademark of the American Television Society. 


1 PostScript ™ is a trademark of Adobe Systems, Inc. 


2 For more information about Digital’s printers .. . 
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<FOOTREF> 


Creates a footnote character in a heading, copyright page, or title page. Also 
used to specify a previously defined footnote in text more than once, and 
along with the <FOOTNOTE> tag, to produce a footnote in a table. 





FORMAT 


<FOOTREF>(char-1 [\ char-2...[\ char-9]]) 





ARGUMENTS 


related tags 


restrictions 


Char-1...9 

Specifies up to nine characters for a footnote. A character can be a single 
character or number, or it can be one of the following keywords denoting 
special characters associated with footnote references: 


DAG (4) 
DDAG () 
R @®) 

S (8) 

TM (™) 


In a table, the reference must be to a number or to one of the special 
characters. 





¢ <FOOTNOTE> 
© <FOOTNOTE_TEXT> 





Invalid in the context of a <MATH> tag. 


You can use only one <FOOTREF> tag per heading or your Bookreader 
bookbuild will fail. 


If you want to generate a special character in the context of footnotes, use 
the <FOOTREF> tag. In other contexts, use the <SPECIAL_CHAR> tag, or you 
may encounter Bookreader bookbuilding problems. 


When using this tag in an argument list, you must place the tag at the 
end of the argument you want to footnote; you cannot embed it in text. 
The end of an argument is indicated by a backslash (\) and the end of an 
argument list is indicated by a closing parenthesis ()). 


DESCRIPTION 
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The <FOOTREF> tag creates a footnote character in a heading, copyright 
page, or title page. It is also used to specify a previously defined footnote 
in text more than once, and along with the <FOOTNOTE> tag, to produce a 
footnote in a table. 


The <FOOTREF> tag causes as many as nine superscripted characters to 
appear where you place the tag in your file. 


<FOOTREF> 


You must use the <FOOTREF> tag: 


¢ To specify footnotes in the argument to a <HEADn> tag and <COMMAND_ 
SECTION_HEAD> and <SUBCOMMAND._SECTION_HEAD> tags of the 
SOFTWARE doctype 


¢ To specify footnotes on a copyright page and title page 
¢ To specify the same footnote in text more than once 


¢ To specify a footnote in a table 


To footnote information in a heading, use a combination of two tags: 
<FOOTREF> and <FOOTNOTE_TEXT>. Place the <FOOTREF> tag in the 
argument to the heading to refer to the <FOOTNOTE_TEXT> tag. Place 
the <FOOTNOTE_TEXT> tag on the line directly following the <HEADn> tag. 


For Bookreader output, you can use only one <FOOTREF> tag per heading. 
Also, the character or number that the <FOOTREF> tag produces is a 
hotspot. 


To use a footnote in a table, use a combination of tags: <FOOTNOTE> and 
<FOOTREF>. Define the <FOOTNOTE> tag just after the <TABLE_SETUP> tag. 
Then use the <FOOTREF> tag to label the footnote references within the 
argument to a <TABLE_ROW> tag; do not define the footnote within a table 
row. The <FOOTREF> tag causes the text of the footnote to appear at the 
bottom of the table for both printed and Bookreader output. For a printed 
document, if the table is longer than a single page, and if the <FOOTREF> 
tag appears multiple times, the footnote text appears at the bottom of the 
table on each page containing the reference. 


If you have a footnote in text that you want to refer to more than once, 
use a <FOOTNOTE> tag directly after the text to label the first occurrence of 
the footnote and the <FOOTREF> tag to label the subsequent references to 
that note. The <FOOTREF> tag always refers to the most recent occurrence 
of the <FOOTNOTE> tag that uses the same argument number or character. 


Note: The text formatter does not automatically repeat text footnotes, 
except for multipage tables, if references are output on more 
than one page. You must reenter the footnote for it to appear on 
another page. 


EXAMPLES See the examples in the discussion of the <FOOTNOTE> and <FOOTNOTE_ 
TEXT> tags. 
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<FORMAT> 


<FORMAT> 


Enables the <FCMD>, <FPARM>, and <FPARMS> tags to distinguish formatted 
command keywords and parameters. 





FORMAT | heading text [ \ WIDE] 
F I 
<FORMA >I { Wi 1 





ARGUMENTS heading text 


This is an optional argument. It specifies a heading. 


WIDE 

This is an optional keyword argument. It specifies, for doctypes in which 
the left margin is indented, that the body of the formatted text be extended 
into the margin. 











related tags ° <FCMD> 
¢ <FPARM> 
¢ <FPARMS> 
restrictions Invalid in the context of <EXAMPLE>, <FIGURE>, <MATH>, and <TABLE> tags. 
required <ENDFORMAT> 
terminator 





DESCRIPTION _ The <FORMAT> tag enables the <FCMD>, <FPARM>, and <FPARMS> tags to 
distinguish formatted command keywords and parameters. 





EXAMPLE See the examples in the discussion of the <FCMD> tag. 


1-108 


<FPARM> 


Specifies a parameter to be formatted following the <FPARMS> tag, aligned 
under the parameters portion of a keyword/parameters pair. 





FORMAT <FPARMS> (parameter) 





ARGUMENTS parameters 


Lists additional command parameters, if any. 








related tags ° <FCMD> 
°¢ <FORMAT> 
e <FPARMS> 
restrictions Valid only in the context of a <FORMAT> tag. 





DESCRIPTION The <FPARM> tag specifies a parameter to be formatted following the 
ge . <FPARMS> tag, aligned under the parameters portion of a keyword/ 
parameters pair. 





EXAMPLE See the examples in the discussion of the <FCMD> tag. 
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<FPARMS> 


Specifies the parameter portion of a command/parameter pair in a format 
section. 





FORMAT 


<FPARMS=> (parameters) 





ARGUMENTS 


related tags 


Par ameters 
Lists the command parameters, if any. If there are no parameters, you 
must specify the argument as null: <FPARMS> (). 





e <FCMD> 
@ <FORMAT> 
e <FPARM> 











restrictions Valid only in the context of a <FORMAT> tag. 

DESCRIPTION _ The <FPARMS> tag specifies the parameter portion of a formatted 
command/parameter pair in a format section. 

EXAMPLE See the examples in the discussion of the <FCMD> tag. 
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<FRONT_MATTER> 


<FRONT_ MATTER> 


Begins the front matter of a book. 





FORMAT 


<FRONT_MATTER>/(symbol name)] 





ARGUMENTS 


related tags 


required 
terminator 


symbol name 
This is an optional argument. It specifies the term that you assign to the 
front matter. A symbol name argument is required if the front matter is 
part of a bookbuild. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





¢ See the list of tags in the description section. 





<ENDFRONT_MATTER> 


DESCRIPTION 


The <FRONT_MATTER> tag begins the front matter of a book. You must use 
front matter to create a book for Bookreader. The following tags are used 
to create the front matter: 


e <ABSTRACT> 
e <CONTENTS_FILE> 
e <COPYRIGHT_DATE> 


<COPYRIGHT_PAGE> 


<FRONT_MATTER> 


<ORDER_NUMBER> 


<PREFACE> 


<PREFACE_SECTION> 


<PRINT_DATE> 


<REVISION_INFO> 


<TITLE> 


<TITLE_PAGE> 
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<FRONT_MATTER> 





EXAMPLE The following example shows the order of all the front matter tags and 
how you can use them in a file that contains the front matter of a book. 


<FRONT_MATTER> (front) 

<TITLE_PAGE> 

<DEFINE_BOOK_NAME> (using _global_tags\Using Global Tags) 
<TITLE> (<REFERENCE> (using_global_ tags) ) 

<ORDER_NUMBER> (xx-12345) 

<ABSTRACT> 

This book describes all the global tags. 

<ENDABSTRACT> 

<REVISION_INFO>(Revision/Update Information:\This is a new manual.) 
<ENDTITLE_PAGE> 

<COPYRIGHT PAGE> 

<PRINT_DATE> (March 1987) 

<COPYRIGHT DATE> (1987) 

<ENDCOPYRIGHT PAGE> 

<CONTENTS_FILE> 

<PREFACE> (11) 

<PREFACE SECTION>(The changes to your system) 
<ENDPREFACE> 

<ENDFRONT_MATTER> 
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<GDEF> 


Labels the text that defines a term in a glossary or anywhere in a document. 





FORMAT <GDEF> 





ARGUMENTS = None. 





related tags ° <GLOSSARY> 
¢ <GREF> 
°¢ <GTERM> 





DESCRIPTION The <GDEF> tag labels the text that defines a term in a glossary or 
anywhere in a document. Use the <GDEF> tag with the <GTERM> tag, 
which labels the term that you want to define. You have the options of 
using the <GLOSSARY> and <ENDGLOSSARY> tags to establish the beginning 

' and ending format of a glossary, or simply using the <GTERM> and <GDEF> 
tags to create glossary entries anywhere in your document. 





EXAMPLE See the example in the discussion of the <GLOSSARY> tag. 
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<GLOSSARY> 


<GLOSSARY> 


Formats a glossary of terms in a document or book. 


i 





FORMAT 


<GLOSSARY>/(text [\ symbol name])/] 





ARGUMENTS 


related tags 


restrictions 


required 
terminator 


text 

This is an optional argument. It specifies any text string you want to 
label the start of the glossary. If you do not specify any text, the default is 
“Glossary.” 


symbol name 
This is an optional argument. It specifies the term that you use to 
reference the glossary. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





e <GDEF> 
© <GTERM> 





The symbol name argument is required if you include this file in a 
bookbuild. 





<ENDGLOSSARY> 


DESCRIPTION 


The <GLOSSARY> tag formats a glossary of terms in a document or book. 
Follow this with a list of <GTERM> tags, with the glossary terms defined 
as arguments to the <GTERM> tags. You must follow the term with the 
definition, which you label with a <GDEF> tag. For a printed book, the 
glossary appears in the table of contents with the beginning page number. 


If you are creating a book for Bookreader, because the entire glossary is 
an online topic, you have the option of displaying in the table of contents 
the beginning and ending glossary term that comprises each online topic 
of information. See VAX DOCUMENT Producing Online and Printed 
Documentation for more information about setting the online topic level 
for a glossary. 


<GLOSSARY> 





EXAMPLES The following example shows how to use the <GLOSSARY> tags to form a 


separate glossary. 
H | <GLOSSARY\gloss_chap> 
<GTERM> (habitat) 
<GDEF>An area or natural environment. 
<GTERM> (habitual) 
<GDEF>Acting according to habit. 
<GTERM> (hack) 
<GDEF>A worn-out horse. 
<GTERM> (hackneyed) 
<GDEF>Trite, banal. 
<ENDGLOSSARY> 


This example produces the following output: 


Glossary 


habitat: An area or natural environment. 
habitual: Acting according to habit. 
hack: A worn-out horse. 


hackneyed: Trite, banal. 


The following example shows how to code glossary entries that you want 
anywhere in your document, rather than in a separate glossary. 


<GTERM> (habitat) 
<GDEF>(An area or natural environment.) 
<GTERM> (habitual) 
<GDEF> (Acting according to habit.) 


This example produces the following output: 
habitat: An area or natural environment. 


habitual: Acting according to habit. 
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<GREF> 


Marks a cross-reference to a term within a glossary. 





FORMAT <GREF> (glossary term) 





ARGUMENTS ~ glossary term 


Specifies the term referred to. 





related tags ° <GDEF> 
<GLOSSARY> 


<GTERM> 
¢ The following tags label other types of cross-references: 


<REFERENCE> 
<CALLOUT_REF> 





restrictions Invalid in the context of a <MATH> tag. 


DESCRIPTION _ The <GREF> tag marks a cross-reference from anywhere in your document, 
including the glossary, to a term within a glossary. The glossary term 
argument appears in an italic typeface in some doctypes. 


EXAMPLE The following example shows how to use the <GREF> tag to refer to the 
glossary term “cat”. 


<GTERM> (cat) 
<GDEF>(A carnivorous mammal.) 
<GTERM> (cow) 
<GDEF> (The mature female of cattle.) 
<GTERM> (lion) 
<GDEF>(A large <GREF> (cat) .) 
This example produces the following output: 
cat: A carnivorous mammal. 
cow: The mature female of cattle. 


lion: A large cat. 


1-116 


<GTERM> 


Labels a term you want to define in a glossary or anywhere in a document. 





FORMAT 


<GTERM> (term) 





ARGUMENTS 


related tags 


term 
Specifies the term you want to define in the glossary or anywhere in a 
document. 





° <GDEF> 
° <GLOSSARY> 











° <GREF> 

required <GDEF> 

terminator 

DESCRIPTION _ The <GTERM> tag labels a term you want to define in a glossary or 

i anywhere in a document. You must follow the <GTERM> tag with a <GDEF> 

tag, which labels the text that defines the term. To create glossary entries, 
use the <GTERM> and <GDEF> tags in the context of <GLOSSARY> and 
<ENDGLOSSARY> tags. 
See the example in the discussion of the <GLOSSARY> tag. 


EXAMPLE 
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<HEAD> 


Creates an unnumbered heading on the left side of the page. 





FORMAT <HEAD> (heading text [\ symbo/ name]) 





ARGUMENTS heading text 
Specifies the text of the heading. 


symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 





related tags ° <CHEAD> 
¢ <CENTER_LINE> 


e <HEADn> 
e <SUBHEADn> 





DESCRIPTION = The <HEAD> tag creates an unnumbered heading on the left side of the 
page. The heading does not appear in the table of contents. 


EXAMPLE The following example shows how to use the <HEAD> tag. 
<HEAD> (How to Write a Letter\how_to) 

<P> 

The first thing that you should do in writing a letter is to get 

a clean piece of paper and a well-sharpened pencil. 


This example produces the following output: 


How to Write a Letter 


The first thing that you should do in writing a letter is to get a clean piece 
of paper and a well-sharpened pencil. 
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<HEADn> 


<HEADn> 


Marks a heading of the level you specify (<HEAD1> through <HEAD6> in all 
doctypes/bold except MILSPEC; in MILSPEC, <HEAD1> through <HEAD20>). 





FORMAT 


<HEADn> (heading text [\ symbol name]) 





ARGUMENTS 


related tags 


restrictions 


heading text 

Specifies the text of the heading. If the doctype you are using produces 
headings that are all capital letters in your output, those letters will 
appear that way regardless of how you enter them in your input file. 
You should, however, use uppercase and lowercases letters according to 
your local conventions in order to obtain the proper capitalization of the 
heading in the table of contents and in cross-references. 


symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 





°¢ <CHEAD> 

°e <HEAD> 

¢ <SUBHEADI> 
° <SUBHEAD2> 





Invalid in the context of a <FOOTNOTE> tag. 


You must use the symbol name argument when processing a heading for 
Bookreader display. 


DESCRIPTION 


The <HEADn> tag marks a heading of the level you specify (<HEAD1> 
through <HEAD6> in all doctypes/bold except MILSPEC; in MILSPEC, 
<HEAD1> through <HEAD20>). Each of the six heading tags does the 
following: 


¢ Outputs the heading text supplied by its first argument 
¢ Automatically numbers the heading 
¢ Resets all the counters for lower heading levels (if any) 


¢ Specifies the symbol name with which cross-references to that heading 
are made 


Entries for each of the headings may appear in the table of contents, 
depending on the doctype. 
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1.1 


1.2.1 


<HEADn> 


The proper choice of the heading level depends on an understanding of 
the logical structure of the document you are writing. A <HEAD2> tag will 
always be logically subordinate to a <HEAD1> tag. The same is true for the 
relationship between <HEAD3> and <HEAD2> tags, <HEAD4> and <HEAD3> 
tags, and so on. 


Note: If you use the <HEADn> tag in a preface, the headings are output 
without numbers. You can refer to the headings from other parts 
of your document. The headings, however, do not appear in the 
table of contents. 


DOCUMENT considers each first-level heading to be an online topic. See 
VAX DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 





EXAMPLES The following <HEAD1> tag labels a first-level heading. 


| <HEAD1>(Running Tasks\tasks) 
<P>This section explains how the running tasks 


The following <HEAD2> tag labels a second-level heading. 


2 <HEAD2>(More Running Tasks\more_tasks) 
<P>This section explains more specifically how 


The following <HEAD3> tag labels a third-level heading. 


3 <HEAD3>(Final Running Tasks\final_tasks) 
<P>This section explains the final running 


Examples 1, 2, and 3, shown together for comparison, produce the 
following output: 


Running Tasks 


This section explains how the running tasks ... 


Specific Running Tasks 


This section explains more specifically how ... 


1.2.1.1 Final Running Tasks 
This section explains the final running ... 
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<HEADn> 


You could make a cross-reference to the second heading, for example, by 
using the <REFERENCE>(more_tasks) tag. Because that heading is the 
second level of the first section in the document, the reference would be 
output as Section 1.2.1. 


To control the output of the reference, use one of the formats listed in the 
following table: 


Reference Output 
<REFERENCE>(tasks) Section 1.2 
<REFERENCE>(tasks\ value) 1.2 
<REFERENCE=>(tasks\text) Running Tasks 
<REFERENCE>(tasks\ full) Section 1.2, Running Tasks 
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<HELLIPSIS> 


<HELLIPSIS> 


Places horizontal ellipsis points on a line. 





FORMAT <HELLIPSIS> 





ARGUMENTS — ‘one. 





related tags ° <ELLIPSIS> 





restrictions Invalid in the context of a <MATH> tag. 





DESCRIPTION _ The <HELLIPSIS> tag places horizontal ellipsis points on a line. Often, it is 
used to label omitted material. 





EXAMPLE The following example shows how to use the <HELLIPSIS> tag. 


<P>A horizontal ellipsis may provide an indefinite ending <HELLIPSIS> 


This example produces the following output: 


A horizontal ellipsis may provide an indefinite ending ... 
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<HYPHENATE> 


<HYPHENATE> 


Provides information about legal hyphenation of a word. 





FORMAT <HYPHENATE>(part7 | part2/\ part3...[\ part9]]) 


ARGUMENTS _ partt1...part9 | 
Specifies the word of text and up to nine valid hyphenation points. Each 
argument to the tag specifies a portion of the word. Use the backslash to 
indicate the hyphenation points. 











related tags * <FINAL_CLEANUP>(LINE_BREAK) 
e¢ <KEEP> 
e <LINE> 
restrictions Invalid in the context of a <MATH> and an <EXAMPLE> tag. 


DESCRIPTION The <HYPHENATE> tag provides information about legal hyphenation of a 
word. This tag does not force a term to be hyphenated; it merely provides 
the text formatter with information about legal places to hyphenate the 
word. 


Use the <HYPHENATE> tag when you are not satisfied with line breaks 
within paragraphs in your final output, and you determine that the line 
breaks are caused because a word is not being hyphenated. This tag is 
also useful when a word or term (usually a technical term that is not 
commonly used) is not being hyphenated correctly. 


EXAMPLE The following example shows how to use the <HYPHENATE> tag. 


<p>Among the more common literary devices used are 
<hyphenate>(on\o\mat\o\poe\ia) and anthropomorphism. 


This example produces the following output: 


Among the more common literary devices used are onomato- 
poeia and anthropomorphism. 
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<ICON> 





<ICON> 


Allows you to print a small graphic with explanatory text printed to the right or 
left of the graphic. 





FORMAT <ICON> 





ARGUMENTS None. 





related tags ¢ <FIGURE_FILE> 
¢ <ICON_FILE> 


e =6<ICON_TEXT> 





restrictions Use the <ICON> tag for graphics that have a length and width of 
approximately 2 inches. Use the <FIGURE_FILE> tag for larger graphics. 


The output device must support graphics. 





required <ENDICON> 
terminator 





DESCRIPTION The <ICON> tag allows you to print a small graphic with explanatory text 
printed to the right or left of the graphic. 





EXAMPLES The following example shows how to code a graphic on the right, with text 
on the left. . 


<ICON> 

<ICON_FILE> (LNO3\small_art.six\1.5\2.0\RIGHT) 

<ICON_ TEXT> (The text accompanying the 

small piece of art. The text can be smaller or larger 
than the graphic; the <tag>(ICON) tags make the necessary 
adjustments for the output.) 

<ENDICON> 


| —: | 
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<ICON> 


The following example shows one graphic placed on the left, with text on 
the right, followed by a second graphic placed on the right, with text on 
the left. 


<ICON> 

<ICON_FILE>(LNO3\RUNNING SHOES.SIX\13\6) 
<ICON_FILE>(PS\RUNNING_SHOES.PS\13\6) 

<ICON_FILE>(LINE\RUNNING_SHOES\13\6) 

<ICON_FILE> (BOOKREADER\RUNNING_SHOES.BRF\13\6) 

<ICON_TEXT>(The image at the left is of a typical pair of running shoes, 
shown here to illustrate the placement of an icon with text on the right.) 
<ENDICON> 

<ICON> 

<ICON_FILE> (LNO3\FORKLIFT. SIX\10\14\RIGHT) 

<ICON_FILE> (PS\FORKLIFT.PS\10\14\RIGHT) 

<ICON_FILE> (LINE\FORKLIFT\10\14\RIGHT) 

<ICON_FILE> (BOOKREADER\FORKLIFT.BRF\10\14\RIGHT) 

<ICON_TEXT> (The image at the right is of a forklift, shown here to illustrate 
the placement of an icon with text on the left.) 

<ENDICON> 


This example produces the following output: 


The image at the left is of a typical pair of running shoes, 
shown here to illustrate the placement of an icon with text 
on the right. 





running 
a program 


ZK-9557-GE 


The image at the right is of a forklift, 
shown here to illustrate the placement 
of an icon with text on the left. 





ZK-9558—GE 


1-125 


<ICON> 


3} <ICON> 


The following example shows a graphic placed on the right, with wrapping 


text on the left. 


<ICON_FILE> (LNO3\TEXT_PAGE.SIX\11\7.5\RIGHT) 
<ICON_FILE> (PS\TEXT_PAGE.PS\11\7.5\RIGHT) 
<ICON_FILE> (LINE\TEXT_PAGE\11\7.5\RIGHT) 
<ICON_FILE> (BOOKREADER\TEXT_PAGE.BRF\11\7.5\RIGHT) 


<ICON_TEXT>(The image at 
wrapping text. 
wrapping text. 
wrapping text. 
wrapping text. 
wrapping text. 
wrapping text. 
wrapping text. 
wrapping text. 
wrapping text. 
wrapping text. 


wrapping text 
<ENDICON> 
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This example produces the following output: 


The image at the right is a page of text, shown here 
to illustrate wrapping text. The image at the right 
is a page of text, shown here to illustrate wrapping 
text. The image at the right is a page of text, shown 
here to illustrate wrapping text. The image at the 
right is a page of text, shown here to illustrate 
wrapping text. The image at the right is a page of 
text, shown here to illustrate wrapping text. The 
image at the right is a page of text, shown here to 
illustrate wrapping text. The image at the right is a 
page of text, shown here to illustrate wrapping text. 
The image at the right is a page of text, shown here 


the right is a page of text, shown here to illustrate 


illustrate 
illustrate 
illustrate 
illustrate 
illustrate 
illustrate 
illustrate 
illustrate 
illustrate 


The image at the right is page of text, shown here to illustrate 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
The image at the right is a page of text, shown here to 
. \WRAP) 
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to illustrate wrapping text. The image at the right is a page of text, shown 
here to illustrate wrapping text. The image at the right is a page of text, 
shown here to illustrate wrapping text. The image at the right is a page of 


text, shown here to illustrate wrapping text. 


<ICON_FILE> 


<ICON_FILE> 


Specifies a graphics file that accompanies text within the <ICON> and 
<ENDICON> tags. 





FORMAT \file spec 
<ICON_FILE> (target device { Ville spec | 


\ vertical size 
\ horizontal size 
[\ RIGHT]) 





ARGUMENTS #_ farget device 
Specifies a keyword indicating the output device for the graphics 
file. Keywords are provided both for devices that do (LN0O3, PS, and 
Bookreader) and do not (LINE, MAIL, and TERMINAL) support graphics. 
Each keyword allows you to insert the necessary amount of white space 
for the specific output device; keywords for devices that do not support 
graphics allow you to insert blank space in place of an icon. The following 
table lists the output devices and expected output for each keyword. 


Keyword Device Output 

BOOKREADER DECwindows screen The specified graphics file is output 
online using Bookreader. 

LNO3 LNO3 Laser Printer The specified sixel graphics file is 
output as an icon. 

PS PrinTSerRver 40 or The specified PostScript graphics 

LNO3R ScriptPrInTER file’ is output as an icon. 

LINE Line Printer If specified, blank space is output 

MAIL with the file spec argument written 

TERMINAL in that blank space. Use only one 


of these three keywords to indicate 
a monospaced destination. 


'PostScrier graphics files must conform to the Encapsulated PostScript File Format 
published by Adobe Systems, Inc. 


file spec 
Specifies the graphics file. No default file type is supplied. 


SPACE 

This keyword lets you reserve blank space in the output file for an icon. 
You can use it if you do not use the file spec argument. Use SPACE to 
reserve space for art that will be pasted in at a later date, or when you 
expect to process a file for more than one output device, but do not have 
graphics files for all devices. 
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<ICON_FILE> 


related tags 


restrictions 


vertical size 

Specifies the vertical size of the printed graphic in picas (there are 6 picas 
in an inch and 12 points in a pica). This argument must be a nonnegative 
integer or decimal number, including zero. 


horizontal size 

Specifies the width of the printed graphic in picas (there are 6 picas to 
an inch and 12 points in a pica). This argument must be a nonnegative 
integer or decimal number, including zero. 


RIGHT 


This is an optional keyword argument. If you use it, it must come last 
in the argument list. RIGHT specifies that the graphic image be placed 
to the right of the text. If you do not specify this argument, the image is 
placed on the left of the text specified in the <ICON_TEXT> tag. 





© <FIGURE_FILE> 
e 6©<ICON> 
© <ICON_TEXT> 





Valid only in the context of an <ICON> tag. 
The output device must support graphics. 





DESCRIPTION 


The <ICON_FILE> tag specifies a graphics file that accompanies text within 
the <ICON> and <ENDICON> tags. The specified file should be a graphics file 
suitable for printing on the specified output device. 


If you plan to process your file for more than a single destination, you 
can use multiple <ICON_FILE> tags to ensure that the appropriate icon will 
be included for the appropriate destination. An example of this coding is 
provided in the examples in the <ICON> tag description. If you use multiple 
<ICON_FILE> tags in this way, you should specify only a single <ICON_FILE> 
tag for all the monospaced destination keywords (MAIL, TERMINAL, or 
LINE). 


EXAMPLE 
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See the examples in the description of the <ICON> tag. 





<ICON TEXT> 


Labels the text that accompanies a graphic image that you include with the 
<ICON_FILE> tag. 





FORMAT 


<ICON_TEXT>(text [\ WRAP) 





ARGUMENTS 


related tags 


restrictions 


text 
Specifies the text that accompanies the graphic. The text can be as long as 
you want and can include paragraphs and lists. 


WRAP 


This is an optional keyword argument. It specifies that the text wrap 
around the graphic if the text is longer than the graphic. 





e <ICON> 
e =6<ICON_FILE> 





Valid only in the context of an <ICON> tag. 


If you use the WRAP argument, the text cannot contain any <LIST> or <P> 
tags. 





DESCRIPTION 


The <ICON_TEXT> tag labels the text that accompanies a graphic image that 
you include with the <ICON_FILE> tag. The text appears along the side of 
the icon or wraps around the icon if you specify the WRAP argument and 
the text is long enough. 


Both the <ICON_TEXT> and <ICON_FILE> tags must occur in the context of 
the <ICON> and <END_ICON> tags. 





EXAMPLE 


See the examples in the description of the <ICON> tag. 
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<INCLUDE> 


<INCLUDE> 


Specifies the position in a document where you want to include a file for 
processing. 





FORMAT 


<INCLUDE> (file spec) 





ARGUMENTS 


related tags 


restrictions 


file spec 
Specifies the file you want to include. 


If you specify a logical name instead, and the source file is an element of 
a book, you can define the logical name using an <INCLUDES_FILE> tag in 
the profile of the book. If the source file is not an element of a book, or if 
the profile does not contain the <INCLUDES_FILE> tag, be sure to define the 
logical name before processing the file. 





e <EXAMPLE_FILE> 
e <TABLE_FILE> 





Invalid in an argument to a tag. 


In a file that contains a book element that you want to process through 
a bookbuild, make sure to place the book element tag (for example, 
<CHAPTER>) as the first tag in the file. Place the <INCLUDE> tag after 
the book element tag. 





DESCRIPTION 


The <INCLUDE> tag specifies the position in a document where you want to 
include a file for processing. 


EXAMPLE 


The following example shows how to include a file that does the following: 
¢ Contains text that might be repeated multiple times in a source file 


e Is used in more than one document 


<INCLUDE> (doc_local_templates:boilerplate.sdml) 
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If you did not use the file specification 
doc_local_templates:boilerplate.sdml, but instead used a logical name, 
the logical name could be equated to the file specification by using the 
<INCLUDES_FILE> tag in the profile. See the example in the 
<INCLUDES_FILE> tag description. 


<INCLUDES FILE> 


<INCLUDES FILE> 


Equates a logical name with a file specification during processing of a profile. 





FORMAT 


<INCLUDES FILE>(/logical name \ file spec) 





ARGUMENTS 


related tags 


restrictions 


logical name 
Specifies the logical name for the included file. (You can use this name as 
the argument to an <INCLUDE> tag.) 


file spec 
Specifies the file specification into which the logical name translates. 





e <ELEMENT> 
e = 6<INCLUDE> 
°e <PROFILE> 





Valid only in the context of a <PROFILE> tag. 


DESCRIPTION 


The <INCLUDES_FILE> tag equates a logical name with a file specification 
during processing of a profile. You can place the <INCLUDES_FILE> tag in 
your profile to define a logical name for a file whose contents are included 
in one of your element files. The first argument to this tag is the logical 
name for the included file. (You use this name as the argument to the 
<INCLUDE> tag.) The second argument specifies the actual file specification 
into which the logical name translates. 


You do not need to use the <INCLUDES_FILE> tag if either of the following is 
true: 


¢ Your element file does not contain any <INCLUDE> tags. 


e The <INCLUDE> tags in your element file have complete file 
specifications as arguments. 


The <INCLUDES_FILE> tags follow the <ELEMENT> tag for which they are 
needed. During a bookbuild, VAX DOCUMENT establishes the logical 
name definition for each <INCLUDES_FILE> tag before it actually reads and 
processes the book element file names in the preceding <ELEMENT> tag. 
The logical name remains defined during the processing of later book 
elements. | 


When a book element is processed by itself (when you use the /PROFILE 
qualifier on the command line), VAX DOCUMENT again establishes the 
logical name definitions that were specified by the <INCLUDES_FILE> tag in 
the profile. 
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<INCLUDES FILE> 





EXAMPLE The following example shows how to use the <INCLUDES_FILE> tag to define 
a logical name for the file MY_VERY_LONG_TABLE.SDML, which is 
kept in the directory [mydirectory]. In the book element file ERROR_ 
CHAP.SDML, you include the table with the <INCLUDE>(error_msg_tab) tag. 


<PROFILE> 


<ELEMENT> (error_chap.sdml) 
<INCLUDES FILE>(error_msg_tab\mydisk: [mydirectory]my very long table.sdml) 


<ELEMENT> (tags_chap.saml) 
<ENDPROFILE> 
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<INDEX_FILE> 


<INDEX FILE> 


Specifies the position in a book or document where you want to include an 
index file in the output. 





FORMAT <INDEX_FILE>/(file spec)] 





ARGUMENTS __ file spec 
This is an optional argument. It specifies the name of the index file. Use 
this argument if you want to include an index file with a name other than 
the default file name. 


The default file name is file spec_index.DVI_device. If you specify a file 
type, be sure that the device name matches the destination device you 
specify on the DOCUMENT command line. For example, if you specify 
file spec_index.DVI_PS, be sure you specify PS as the destination on the 
command line. 





related tags ° <CONTENTS_FILE> 
° <PROFILE> 


DESCRIPTION The <INDEX_FILE> tag Specifies the position in a book or document where 
you want to include an index file in the output. This tag does not produce 
an index, but instead indicates placement of the index file. An index file 
is produced when you specify the /INDEX qualifier on the DOCUMENT 
command line. See Appendix A for information about using the /INDEX 
qualifier on the command line. 


Using the <INDEX_FILE> tag is highly recommended (but not required) for 
Bookreader output, because an index is helpful for locating information in 
a book you create for Bookreader. 


It is recommended that you place the <INDEX_FILE> tag in your profile. 
This ensures correct placement of the index in both printed and 
Bookreader output. 


An index file always receives the file type .DVI _device, where device is the 
type of output device you specified on the DOCUMENT command line. To 
generate an index from an individual file that contains an <INDEX_FILE> 
tag, specify the /INDEX qualifier on the DOCUMENT command line. 


If you specify the /INDEX qualifier on the DOCUMENT command 

line without using the <INDEX_FILE> tag in your profile, an index is 
generated separately from your document. For more information on 
generating an index, see VAX DOCUMENT Producing Online and Printed 
Documentation. 
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<INDEX_FILE> 





EXAMPLE See the index in this manual for a sample index. The <INDEX_FILE> tag is 
placed in the profile file after the last appendix file. See the <PROFILE> tag 
description for an example of an <INDEX_FILE> tag in a profile. 
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<INTERACTIVE> 


<INTERACTIVE> 


Begins an example dialog between the user and system and enables the <S> 
and <U> tags to distinguish system text from user text. 








FORMAT <INTERACTIVE> (code) 
or 
| [KEEP] \ [WIDE] 
<INTERACTIVE>/( \ MAXIMUM] )] 
interactive code or text 
<ENDINTERACTIVE> 
ARGUMENTS code 


Specifies a code fragment you want to insert into your text. 


If you do not specify this argument, you must use <ENDINTERACTIVE> as 
the terminating tag. 


KEEP 

This is an optional keyword argument. It specifies that the example is 
not to be broken across pages; that is, if the example does not fit on the 
current page, it will be placed on the next page. If the example itself does 
not fit on an entire single page of output, it will be broken anyway. This 
keyword has no effect for Bookreader output. 


WIDE 

This is an optional keyword argument. It specifies that the width of the 
example exceeds the document’s default width for text, and, depending on 
the doctype, is interpreted as follows: 


e Ifthe doctype contains a left margin area that is normally used for 
headings, the example’s width spans that area as well as the normal 
text area. 


¢ Ifthe document uses a multicolumn format, multicolumn output is 
suspended while the example is processed. The example is output and 
multicolumn output is then restored. 


¢ Depending on the doctype, this argument provides a range of font sizes 
and font styles for examples. . 
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<INTERACTIVE> 


Note: 


related tags 


restrictions 


required 
terminator 


MAXIMUM 


This is an optional keyword argument. It specifies that the text of the 
code example is adjusted to a smaller point size in order to fit within the 
boundaries of the left and right margins of the page. You can use this 
keyword in conjunction with WIDE to indicate that the example may 
require additional adjustment to fit within the boundaries of the page. You 
should use this keyword with discretion, and it may not be suitable in all 
doctypes. 


You can use the KEEP, WIDE, and MAXIMUM keywords together 
or separately and in any order in the argument list. 





e =©<VALID_BREAK> 





You cannot use indexing tags (<X> and <Y> tags) in the context of an 
<INTERACTIVE> tag. 


You cannot use tab characters to format interactive examples; use spaces 
instead. 


You cannot use text element tags, such as <P>, <LIST>, or <NOTE>, in the 
context of an <INTERACTIVE> tag. 





<ENDINTERACTIVE> — Required if you do not specify an argument to the 
<INTERACTIVE> tag. 





DESCRIPTION 


The <INTERACTIVE> tag begins an example dialog between the user and 
system and enables the <S> and <U> tags to distinguish system text from 
user text. If your interactive example is longer than a few lines, use 
the <VALID_BREAK> tag to indicate the acceptable points for a page break 
within that example. 





EXAMPLE 


This example shows how to use the tags to create an interactive example. 
Note that you should specify whatever space follows the system prompt 
within the <S> tag. 


<P>If you do not specify the full command line, DCL will prompt 
you for the missing information. For example, if you do not specify an 
input file and an output file when you enter the COPY command, you will 


be prompted as follows: 
<INTERACTIVE> 
<S>($ )<U>(COPY) 


<S>($_From: )<U>(INTERACT.SDML) 
<S>($_To: )<U>(NEWFILE.SDML) 


<ENDINTERACTIVE> 
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This example produces the following output: 


<INTERACTIVE> 


If you do not specify the full command line, DCL will prompt you for the 
missing information. For example, if you do not specify an input file and 
an output file when you enter the COPY command, you will be prompted 
as follows: 


$ COPY 


$ From: INTERACT. SDML 
$ To: NEWFILE.SDML 
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<KEEP> 


Specifies that a string of text should not be broken across a line of output. 





FORMAT <KEEP3> (text) 





ARGUMENTS __ text , 


Specifies the text string you want kept on the same line of output. 





related tags ¢ You can use the following tags in conjunction with the <KEEP> tag to 
allow you to specify formatting attributes: 


<DEFINE_SYMBOL> 
<EMPHASIS> 
<HYPHENATE> 





DESCRIPTION — The <KEEP> tag specifies that a string of text should not be broken across 
a line of output. Use this tag to specify a string of text you want kept on 
the same line of output. 


EXAMPLES In the following example, the file specification is specified as an argument 
to the <KEEP> tag so that it will not be broken across a line. 


<P> 
The complete file specification is: <KEEP> (DISKS: [SMITH.TRIPS.EXPENSES}MILBAGE.TXT) 


This example produces the following output: 


The complete file specification is: 
DISK$:[SMITH.TRIPS.EXPENSESJMILEAGE.TXT 


The following example defines a text element symbol name using an en 
dash and specifies that the line should not break between the en dash and 
the 11 when you refer to the symbol. 


<define_symbol>(vax11\<delayed><keep> (vax--11) <enddelayed>) 


LDS | 


You refer to the symbol with the <REFERENCE>(vax11) tag, which produces 
the following output: 


VAX-11 
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<KEYWORD> 





<KEYWORD> 


Labels a word that you want to distinguish typographically. 





FORMAT <KEYWORD> (word) 





ARGUMENTS word 


Specifies the word you want to distinguish. 





related tags ° <NEWTERM> 
¢ <SPECIAL_CHAR> 


e@ <VARIABLE> 





DESCRIPTION _ The <KEYWORD> tag labels a word that you want to distinguish 
typographically. The default action of the <KEYWORD> tag outputs the 
keyword in boldface. As formatted output, the <KEYWORD> tag may 
appear similar to the <EMPHASIS> tag with the BOLD argument. By using 
separate tags to label different kinds of information, however, you are free 
to change the format of any one kind of information without affecting the 
others. 


What constitutes a keyword is something about which both editor and 
writer must agree. Use the <KEYWORD> tag consistently within a document 
and across a document set. 


EXAMPLE The following example shows how to use the <KEYWORD> tag. 
<P>A <KEYWORD> (field) is a set of contiguous bytes in a logical record. 


This example produces the following output: 


A field is a set of contiguous bytes in a logical record. 
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<LANGUAGE> 


<LANGUAGE> 


Causes text that is automatically generated by VAX DOCUMENT (such as 
“Example”, “Figure”, “Table”, and so on) to be output in the language you 
specify. It also causes text to be hyphenated and index entries to be sorted 
according to the rules of the language you specify. 





FORMAT 


CANADIAN 
DANISH 
DUTCH 
ENGLISH 
FINNISH 
<LANGUAGE>( ia ) 
ITALIAN 
NORWEGIAN 
PORTUGUESE 
SPANISH 
SWEDISH 





ARGUMENTS 


restrictions 


language-x 
Specifies the language. English is the default language. Note that 
CANADIAN specifies the French Canadian language. 





You can use this tag only once in a file; subsequent occurrences of the tag 
are ignored. 


You must place this tag at the beginning of your file or immediately after 
the <PROFILE> tag in a profile. 


DESCRIPTION 
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The <LANGUAGE> tag causes text that is automatically generated by VAX 
DOCUMENT (such as “Example”, “Figure”, “Table”, and so on) to be 
output in the language you specify. It also causes text to be hyphenated 
and index entries to be sorted according to the rules of the language you 
specify. 


To use the default foreign language text, use the <LANGUAGE> tag with the 
argument of your choice. You can change the default foreign language text 
as follows: 


1 To modify the output for individual use only, copy DOC$STANDARD_ 
FORMATS: TEX$LANGUAGE_MODULES.TEX into a directory and 
define the logical name DOC$PERSONAL_FORMATS to point to that 
directory. For example: 


<LANGUAGE> 


$ DEFINE DOCSPERSONAL | FORMATS DISK1: [MYDIR]} 


To modify the output for all users on the system, copy 
DOC$STANDARD_FORMATS:TEX$LANGUAGE_MODULES.TEX 
into a directory and define the logical name DOC$LOCAL_FORMATS 
to point to that directory. 


Edit this local copy of TEX$LANGUAGE_MODULES.TEX by 
uncommenting the line that inputs the language you want to change. 
In the following example, the line that inputs the Danish language 
file has been uncommented, so that a local copy of TEX$DANISH_ 
MODULE.TEX will be used instead of the default version. 


s\input doc$$dormats:tex$canadian_module.tex 
\input doc$$dormats:tex$danish_module.tex %$ enables your Danish changes 
$\input doc$$dormats:tex$dutch_module.tex 


2 


3 The text for the supported languages is contained in the following files. 


Copy the file you wish to change into a local directory and edit the file 
for local language changes. 


TEX$CANADIAN_MODULE.TEX 
TEX$DANISH_MODULE.TEX 
TEX$DUTCH_MODULE.TEX 
TEX$ENGLISH_MODULE.TEX 
TEX$FINNISH_MODULE.TEX 
TEX$FRENCH_MODULE.TEX 
TEX$GERMAN_MODULE.TEX 
TEX$ITALIAN_MODULE.TEX 
TEX$NORWEGIAN_MODULE.TEX 
TEX$PORTUGUESE_MODULE.TEX 
TEX$SPANISH_MODULE.TEX 
TEX$SWEDISH_MODULE.TEX 


4 You can modify any of the text strings by entering new text within the 


braces for a specific macro. 


The hyphenation patterns for the supported languages are contained 

in the file TEX$EXCEPTIONS.TEX. The default version of this file, 
which resides in DOC$STANDARD_FORMATS, is invoked when the text 
formatter begins processing. You can modify the hyphenation of any word 
as follows: 


To change the hyphenation for individual use only, copy 
DOC$STANDARD_FORMATS:TEX$EXCEPTIONS.TEX into a 
directory, define the logical name DOC$PERSONAL_FORMATS to 
point to that directory, and edit the file. 


To change the hyphenation for all users on the system, copy 
DOC$STANDARD_FORMATS:TEX$EXCEPTIONS.TEX into a 
directory, define the logical name DOC$LOCAL_FORMATS to point to 
that directory, and edit the file. | 
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<LANGUAGE> 


VAX DOCUMENT searches for a copy of TEX$LANGUAGE_ 
MODULES.TEX and TEX$EXCEPTIONS.TEX in the order listed below, 
and uses the first copy of each file that it encounters: 


1 DOC$PERSONAL_FORMATS—for individual use 
2 DOC$LOCAL_FORMATS—for local use 
3 DOC$STANDARD_FORMATS—the default version 





EXAMPLES The following example shows how to code a file using the <LANGUAGE> tag. 


<LANGUAGE> (FRENCH) 
<CHAPTER>(Le Tour De France) 
<P> La plus longue course de bicyclettes du monde a lieu en France chaque anneé au 
debit de 1’été: c’est le Tour de France. 


The following example is part of the English language section of 
TEX$EXCEPTIONS.TEX, to which you add the hyphenation exception 
in the format shown. 


\gdef\ENGLexceptions{ 
\hyphenation{ 
as-so-ciate 
as-so-ciates 
dec-li-na-tion 
oblig~a-tory 

} 

} 


1-142 


<LE> 





Labels a list element. 





FORMAT <LE>/(callout number)] 





ARGUMENTS ~ callout number 


This is an optional argument. It sets the callout number identifying the 
list element. 





related tags ° <LIST> 





restrictions Valid only in the context of a <LIST> tag. 


You can use the callout number argument of the <LE> tag only in the 
context of a <LIST>(CALLOUT) tag. 





DESCRIPTION The <LE> tag labels a list element. 





EXAMPLES See the examples in the discussion of the <LIST> tag. 
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<LINE> 


<LINE> 


Specifies that the text that follows this tag be placed on a new line of output. 








FORMAT INDENT [ \ unit number] 
<LINE>/({ BIGSKIP 
SMALLSKIP 
ARGUMENTS  /NDENT 


related tags 


restrictions 


This is an optional keyword argument. It specifies that the next line or 
block of text be indented from the preceding text. 


unit number 

If you use INDENT, you have the option of specifying a unit number from 
2 to 9 indicating the number of units that the text is to be indented. The 
default indent is 1 unit. The size of these units is determined separately 
for each doctype. 


BIGSKIP 


SMALLSKIP 


These are optional keyword arguments. They specify that a set amount of 
vertical space precede the element identified as a line or block of text. The 
actual amount of space created is determined by the doctype. 





¢ <CENTER_LINE> 
¢ =<FINAL_CLEANUP> 
¢ = <RIGHT_LINE> 





Invalid in the context of an <EXAMPLE> and a <MATH> tag. 


DESCRIPTION 
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The <LINE> tag specifies that the text that follows this tag be placed on 
a new line of output. The result of using the <LINE> tag differs according 
to whether you use it in the context of a <P> tag, a <TABLE_ROW> tag, or a 
<FORMAT> tag: 


e When you specify the <LINE> tag in the context of a paragraph of text 
or a list element, the <LINE> tag ends the current paragraph or list 
element and then starts a new block of text. By default, the block of 
text is not preceded by any extra vertical space, nor is it indented. 


When you specify the <LINE> tag in the context of a <TABLE_ROW> or a 
<FORMAT> tag, the <LINE> tag causes the following text to begin on a 
new line of output, but does not modify the current paragraph. 


<LINE> 


Be sure that you want a line break in all formatting cases, including 
Bookreader output. Do not use the <LINE> tag in a paragraph simply to 
cause the text formatter to break a line within the paragraph. Breaking a 
line to override a specific line break is a final formatting instruction; use 
the <FINAL_CLEANUP>(LINE_BREAK) tag for this. 


A mE a a a I a Na I aL 
EXAMPLES The following example shows how to use the <LINE> tag in a list. 


<LIST> (NUMBERED ) 
<le>ITEM 
<LINE>This item specifies... 


This example produces the following output: 


1 ITEM 
This item specifies ... 


The following example shows how to use the <LINE> tag to create an 
indented line with a small skip. 


<P>This is a normal paragraph. 
<line> (INDENT\1\SMALLSKIP) 
This is a block paragraph, indented with a small skip. 


This example produces the following output: 
This is a normal paragraph. 
This is a block paragraph, indented with a small skip. 


The following example shows the misuse of the <LINE> tag for formatting 
within a paragraph. 

<P>Elaborate designs are inappropriate for software manuals or for 

any serious or formal books because they do not reflect the 

intention of the writer. The purpose of any book design is<LINE> 

to clarify what the author is conveying, to translate the text 


attractively as print on a page, to communicate the message 
visually in harmony with the ideas. 


Although the correct output may result on a given output device for a 
particular run of a file, the output may also be formatted incorrectly, as 
follows: 


Elaborate designs are inappropriate for software manuals or for any 
serious or formal books because they do not reflect the intention of the 
writer. The purpose of any book design is 

to clarify what the author is conveying, to translate the text attractively 
as print on a page, to communicate the message visually in harmony with 
the ideas. 


The following example shows how to use the <LINE> tag in a three-column 
table. 
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<LINE> 


<TABLE> (Card Reader Errors: Causes and Corrective Actions\cardread_tab) 
<TABLE_ATTRIBUTES> (wide\multipage) 

<TABLE_SETUP> (3\12\21) 

<TABLE_HEADS> (Error\Causes\Corrective Action) 

<TABLE _ROW>(READ CHECK\Card edges torn <LINE> Punch in column 0 

or 81\Remove the faulty card from the output stacker, duplicate the card, place 
it in the input hopper, and press the <EMPHASIS>(RESET\bold) button.) 
<TABLE _ROW_BREAK> (FIRST) 

<TABLE ROW> (PICK CHECK\Damage to leading edge <LINE> Torn webs 

<LINE> Cards 

stapled together\Remove the card from the input hopper, duplicate 

the faulty card, place the card back in the input 

hopper, and press the <EMPHASIS>(RESET\bold) button.) 
<TABLE ROW _BREAK> (LAST) 

<TABLE _ROW> (STACK CHECK\Jam in the card track <LINE> Badly mutilated card 
\Correct the jam and/or remove the mutilated card from the output stacker, 
duplicate the card, place it in the input hopper, and press the 
<EMPHASIS> (RESET\bold) button.) 

<TABLE _ROW> (HOPPER CHECK\Input hopper empty <LINE> Output stacker full\Load 
the input hopper. <LINE> Unload the output stacker.) 

<ENDTABLE> 


ES 


This example produces the following output: 


Table n—n Card Reader Errors: Causes and Corrective Actions 








Error Causes Corrective Action 
READ CHECK Card edges torn Remove the faulty card from the output stacker, 
Punch in column 0 or 81 duplicate the card, place it in the input hopper, and 
press the RESET button. 
PICK CHECK Damage to leading edge Remove the card from the input hopper, duplicate the 
Torn webs faulty card, place the card back in the input hopper, and 
Cards stapled together press the RESET button. 
STACK CHECK Jam in the card track Correct the jam and/or remove the mutilated card from 
Badly mutilated card the output stacker, duplicate the card, place it in the 
input hopper, and press the RESET button. 
HOPPER CHECK Input hopper empty Load the input hopper. 
Output stacker full Unload the output stacker. 





The following example shows how to use the <LINE> tag in the context of a 
<FORMAT> tag. 


17} 


<FORMAT> (MY COMMAND) 

<FCMD>( ) 

<FPARMS> (one parameter<line>two<line>three) 
<ENDFORMAT> 


This example produces the following output: 


MY COMMAND one parameter 
two 
three 
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<LINE_ART> 


<LINE ART> 


Labels a rough sketch produced at the terminal keyboard for draft output, to 
give some idea of what the final figure will look like. 





FORMAT <LINE_ART>/(/KEEP] \ [WIDE] \ [MAXIMUM][})] 





ARGUMENTS KEEP 
This is an optional keyword argument. It specifies that the line art not 
be broken across pages; that is, if the line art does not fit on the current 
page, it will be placed on the next page. If the line art itself does not fit 
on a single page of output, it will be broken anyway. This keyword has no 
effect for Bookreader output. 


WIDE 

This is an optional keyword argument. It specifies that the width of the 
line art exceeds the document’s default width for text. Depending on the 
doctype, this argument is interpreted as follows: 


¢ Ifthe doctype contains a left margin area that is normally used for 
headings, the line art’s width spans that area as well as the normal 
text area. 


¢ Ifthe document uses a multicolumn format, the line art suspends the 
multicolumn output while it is being processed. The line art is then 
output, and then multicolumn output is restored. 


¢ Depending on the doctype, this argument provides a range of font sizes 
and font styles for line art. 


MAXIMUM 


This is an optional keyword argument. It specifies that the text of the 
code example is adjusted to a smaller point size in order to fit within the 
boundaries of the left and right margins of the page. You can use this 
keyword in conjunction with WIDE to indicate that the example may 
require additional adjustment to fit within the boundaries of the page. You 
should use this keyword with discretion, and it may not be suitable in all 
doctypes. 


Note: You can use the KEEP, WIDE, and MAXIMUM keywords together 
or separately and in any order in the argument list. 





related tags ° <FIGURE> 
¢ <VALID_BREAK> 





required <ENDLINE_ART> 
terminator 
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<LINE ART> 


DESCRIPTION 


The <LINE_ART> tag labels a rough sketch produced at the terminal 
keyboard for draft output, to give some idea of what the final figure 
will look like. 


Note that the results of keyboard drawing may be adequate for draft 
purposes, but may not be acceptable for laser printer output. 


When you print an informal or formal figure (within which is the line art) 
or process an informal figure for Bookreader display, the figure is indented 
in the same way the regular text is for the particular doctype you are 
using. 





EXAMPLE 
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See the first example in the discussion of the <FIGURE> tag. 


<LIST> 


<LIST> 


Begins a list. You specify the type of list by using a keyword argument to the 


tag. 





<LIST> (keyword \ attribute-1 [\ attribute-2]]) 





FORMAT 
ARGUMENTS KEYWORD 
| Specifies the type of list. The following keywords indicate the type of list. 
ALPHABETIC The list element identifiers are alphabetic letters. 
CALLOUT The list element identifiers are reverse-print callout numbers 
(on supported output devices), for example @. 
NUMBERED The list element identifiers are Arabic numerals. 
ROMAN The list element identifiers are Roman numerals. 
SIMPLE There are no list element identifiers. 
STACKED Individual list elements do not have identifiers, but the entire 


list is stacked within the specified set of delimiters (braces, 
brackets, double brackets, single or double vertical rules). 


UNNUMBERED List element identifiers are special characters. 


ATTRIBUTES 


This is an optional argument. It specifies the attributes of the list element 
keywords. You can specify more than one attribute. 


BRACES 

BRACKETS 
DOUBLE_BRACKETS 
DOUBLE_VERTICAL_RULE 
VERTICAL_RULE 


char 


Start-letter 


start-number 


For a STACKED list. Each attribute fora STACKED 
list specifies the delimiter to be used to surround the 
stacked elements. If you do not specify a keyword, 
list elements are stacked without a surrounding 
delimiter. 


For an UNNUMBERED list. Specifies a single 
character or a tag that results in a single printed 
character of output that is used to indicate list 
elements. If you do not specify char, the bullet 
character is used. 

For an ALPHABETIC list. Specifies the alphabetic 
letter to use for the first item in the sequence. 
Subsequent items are automatically incremented. 
For a NUMBERED or ROMAN list. Specifies the 
number to be assigned to the first list element. 
Subsequent list elements are automatically 
incremented. 
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<LIST> 


related tags 


restrictions 


required 
terminator 


UPPERCASE For an ALPHABETIC or ROMAN list. Specifies 
that the list element identifiers (alphabetic letters 
or Roman numerals) be printed in uppercase. 
By default, Alphabetic and Roman list element 
identifiers are printed in lowercase. 





e =6©<<ALIGN_AFTER> 
°® <ALIGN_CHAR> 
e 6 <LE> 





Valid only in the context of a <P> or a <TABLE> tag. 


You can nest <LIST> tags that use the following keywords: ALPHABETIC, 
NUMBERED, ROMAN, SIMPLE, or UNNUMBERED. (Nesting a list 
means that an element of a list may itself contain the beginning of another 
list.) None of these list types are compatible with the <LIST>(STACKED) tag. 





<ENDLIST> 


DESCRIPTION 
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The <LIST> tag begins a list. You specify the type of list by using a keyword 
argument to the tag. 


The <LIST>(ALPHABETIC), <LIST>(NUMBERED), and <LIST>(ROMAN) tags 
begin a list whose elements have a particular sequence or priority. 

The <LIST>(SIMPLE) or <LIST>(UNNUMBERED) tags begin a list that has no 
inherent order or priority. Alphabetic lists are useful when nested within 
numbered lists. Use a numbered list to indicate a particular sequence or 
priority within the list elements. 


The <LIST>(SIMPLE) tag labels a simple list with no enumerator or special 
character preceding each list element. It terminates the current paragraph 
and indents the list, so that the list is seen as a separate entity from the 
text above and below it. 


The <LIST>(UNNUMBERED) tag labels a list that has no particular order 

or priority within the list element. Normally a bullet is the character 
used before each list element. You can specify another character by using 
it as the second argument to the <LIST>(UNNUMBERED) tag; for example, 
<LIST>(UNNUMBERED\ +). 


Use the <LIST>(STACKED) tag to begin a list whose elements are left-justified 
on successive lines. The block of text can have large braces or brackets 
placed on each side. The block of text is then centered vertically so that it 
aligns with text to the left or right on the same line. The <LIST>(STACKED) 
tag is especially useful for showing syntactic elements with a <FORMAT> 
tag. 


<LIST> 


EXAMPLES The following is an example of nested lists. The first nested list has no 
; particular sequence. The order of the second nested list is reflected in the 
use of the <LIST>(ALPHABETIC) tag. 


<LIST> (NUMBERED) 
<LE>Review the document 
<LE>Find out these numbers: 
<LIST> (UNNUMBERED) 
<LE>number of copies 
<LE>department number 
<LE>order number 
<ENDLIST> 
<LE>For revisions of documents not already in the library, have 
the writer rename the file according to its new order number. 
<LE>Open a library for the book if none exists. 
<LIST> (ALPHABETIC) 
<LE>Decide with the writer about timing: 
<LIST> (UNNUMBERED) 
<LE>Must be done before final production. 
<LE>Should not be done until text is stable. 
<ENDLIST> 
<LE>Cooperate with the business department on paperwork. 
<LE>Help writers name new element files correctly. 
<LE>Verify that all files are of the same file type. 
<LE>For a revision, be sure files are renamed with the new file name. 
<ENDLIST> 
<ENDLIST> 


This example produces the following output: 
1 Review the document 
2 Find out these numbers: 

° number of copies 

¢ department number 

¢ order number 


3 For revisions of documents not already in the library, have the writer 
rename the file according to its new order number. 


4 Open a library for the book if none exists. 
a. Decide with the writer about timing: 
¢ Must be done before final production. 
¢ Should not be done until text is stable. 


b. Cooperate with the business department on paperwork. 

c. Help writers name new element files correctly. 

d. Verify that all files are of the same file type. 

e. For a revision, be sure files are renamed using the new file name. 


The following is an example of an alphabetic list that begins with the 
letter “e”. 
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<LIST> 


<P>Items e and f describe the $GETJPI AST activity: 


<LIST> (ALPHABETIC\e) 

<LE>An ACB is constructed for a special kernel AST. 

<LE>When the special kernel mode AST routine executes in the context of 

the target process, the requested information is moved into the system buffer. 
The ACB is then reset to deliver a special kernel mode AST back to the 


requesting process. 
<ENDLIST> 


This example produces the following output: 
Items e and f describe the $GETJPI AST activity: 
e. An ACB is constructed for a special kernel AST. 


f. When the special kernel mode AST routine executes in the context of 
the target process, the requested information is moved into the system 
buffer. The ACB is then reset to deliver a special kernel mode AST 
back to the requesting process. 


The following is an example of a list with callouts. 


<P>At this point, you can log in to the system as the system manager 

by performing the following steps at the console terminal: 

<LIST> (CALLOUT) 

<LE>Press RETURN. 

<LE>In response to the system’s request for your user name, type SYSTEM. 
<LE>In response to the system’s request for your password, type MANAGER. 
<ENDLIST> 


This example produces the following output: 


At this point, you can log in to the system as the system manager by 
performing the following steps at the console terminal: 


@ Press RETURN. 

@ In response to the system’s request for your user name, type SYSTEM. 

© In response to the system’s request for your password, type 
MANAGER. 


The following is an example of a numbered list. 


<P>At this point, you can log in to the system as the system manager 
by performing the following steps at the console terminal: 
<LIST> (NUMBERED) 


<LE>Press RETURN. 
<LE>In response to the system’s request for your user name, type SYSTEM. 


<LE>In response to the system’s request for your password, type MANAGER. 
<ENDLIST> 


This example produces the following output: 


At this point, you can log in to the system as the system manager by 
performing the following steps at the console terminal: 


1 Press RETURN. 
2 In response to the system’s request for your user name, type SYSTEM. 


3 In response to the system’s request for your password, type 
MANAGER. 
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<LIST> 


The following is an example of a numbered list that begins with the 
number “6”. 


<P>Items six and seven describe two main principles of a generic 

markup language: 

<LIST> (NUMBERED \ 6) 

<LE>Descriptive markup predominates and is distinguished from processing 
instructions. 

<LE>Markup is formally defined for each type of document. 

<ENDLIST> 


This example produces the following output: 


Items six and seven describe two main principles of a generic markup 
language: 


6 Descriptive markup predominates and is distinguished from processing 
instructions. 


7 Markup is formally defined for each type of document. 


The following is an example of a list that begins with the Roman numeral 


65 99 


Iv. 


<P>Items six and seven describe two main principles of a generic 

markup language: 

<LIST> (ROMAN\4) 

<LE>Descriptive markup predominates and is distinguished from processing 
instructions. 

<LE>Markup is formally defined for each type of document. . 

<ENDLIST> 


This example produces the following output: 


Items six and seven describe two main principles of a generic markup 
language: 


iv Descriptive markup predominates and is distinguished from processing 
instructions. 


v Markup is formally defined for each type of document. 


The following is an example of a simple list. 


<P>The following items are needed: 
<LIST> (SIMPLE) 

<LE>bread 

<LE>milk 

<LE>cheese 

<LE>cereal 

<LE>fruit 

<ENDLIST> 


This example produces the following output: 
The following items are needed: 

bread 

milk 

cheese 


cereal 
fruit 
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<LIST> 


The following is an example of two stacked lists with braces around the list 
elements. The tags are indented to help in visually checking the matching 
of the <LIST>(STACKED) and <ENDLIST> tags. This indentation has no effect 
on the output, however. 


3 <P> 
ON <LIST>(stacked\braces) 
<LE>ANYCONDITION 
<LE>ENDFILE (reference) 
<LE>ENDPAGE (reference) 
<LE>FINISH 
<LE>KEY (reference) 
<LE>UNDEFINEDFILE (reference) 
<LE>ERROR 
<LE>FIXEDOVERF LOW 
<LE>OVERF LOW 
<LE>UNDERF LOW 
<LE>VAXCONDITION (expression) 
<LE>ZERODIVIDE 
<ENDLIST> 


<LIST> (stacked\braces) 
<LE>statement 
<LE>begin-block 
<ENDLIST> 


This example produces the following output: 


ANYCONDITION 
ENDFILE(reference) 
ENDPAGE(reference) 
FINISH 
KEY(reference) 
on ) UNDEFINEDFILE(reference) aerate } 
ERROR begin-block 
FIXEDOVERFLOW 
OVERFLOW 
UNDERFLOW 
VAXCONDITION(expression) 
ZERODIVIDE 


The following is an example of nested and stacked lists with brackets. 


<P> 
g OPEN FILE (reference) [TITLE (expression) ] 
<P> 
<LIST> (stacked\brackets) 
<LE>{STREAM] <LIST>(stacked\brackets) 
<LE> [INPUT] 
<LE>OUTPUT [LINESIZE] [PRINT [PAGESIZE(integer)] ] 
<ENDLIST> 
<LE>RECORD <LIST>(stacked\brackets) 
<LE> (INPUT ] 
<LE>OUTPUT 
<LE>UPDATE 
<ENDLIST> 
<LIST> (stacked\brackets) 
<LE>DIRECT 
<LE> [SEQ [UENTIAL] ] 
<ENDLIST> 
[KEYED] 
<ENDLIST> 


This example produces the following output: 
OPEN FILE (reference) [TITLE(expression)] 
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<LIST> 


[STREAM] | [INPUT] 


OUTPUT [LINESIZE] [PRINT [PAGESIZE(integer)] ] 


RECORD | OUTPUT | 
UPDATE [SEQIUENTIAL]] 


The following is an example of stacked lists with braces used within a 
table. The <LIST> tags are indented simply as an aid for visually checking 
the nesting of tags. 


| [KEYED] 


<TABLE> 
<TABLE_SETUP> (2\20) 
<TABLE_HEADS> (Items\Description) 
<TABLE_ROW> (<LIST>(stacked\braces) 
<LE>one 
' <LE>two 
<LE>three © 
<ENDLIST>\Stacked in a table.) 
<TABLE_ROW> (Another item\<LIST> (stacked\braces) 
<LE>one 
<LE>two 
<LE>three 
<ENDLIST>) 
<TABLE_ROW>(This is the last item\) 
<ENDTABLE> 


This example produces the following output: 





items Description 


one Stacked in a table. 
two 
three 
-Another item ine 
two 
three 


This is the last item 





The following is an example of an unnumbered list. 


1 4] <P>To create a system that more closely suits the requirements of 
your site, you can do. any of the following: 
<LIST> (UNNUMBERED) 
<LE>Select a default bootstrap command procedure 
<LE>Modify system parameters for special hardware configuration needs or 
special workload requirements 
<LE>Perform other site-specific modifications 
<ENDLIST> 


This example produces the following output: 


To create a system that more closely suits the requirements of your site, 
you can do any of the following: 


e Select a default bootstrap command procedure 


¢ Modify system parameters for special hardware configuration needs or 
special workload requirements 


Perform other site-specific modifications 
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<LIST> 


The following is an example of how you can specify a character other than 
a bullet to label each list element. 


1.2] <P>To create a system that more closely suits the Bede rencnee of 
your site, you can do any of the following: 

<LIST> (UNNUMBERED \+) 
<LE>Select a default bootstrap command procedure 
<LE>Modify system parameters for special hardware configuration needs or 
special workload requirements 
<LE>Perform other site-specific modifications 
<ENDLIST> 


This example produces the following output: 


To create a system that more closely suits the requirements of your site, 
you can do any of the following: 


+ Select a default bootstrap command procedure 


+ Modify system parameters for special hardware configuration needs or 
_ special workload requirements 


+ Perform other site-specific modifications 
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<LITERAL> 


<LITERAL> 


Allows you to specify text that contains words in angle brackets that might 
otherwise be interpreted as tags. 





FORMAT <LITERAL> (literal text) 
or 
<LITERAL> | 
literal text 


<ENDLITERAL> 


ARGUMENTS __ literal text 


Specifies the literal text to be output exactly as you code it. 








restrictions Do not nest a <LITERAL> tag within another <LITERAL> tag. 
required <ENDLITERAL+ —Required if you do not specify an argument to the 
terminator <LITERAL> tag. 


DESCRIPTION The <LITERAL> tag allows you to specify text that contains words in angle 
brackets that might otherwise be interpreted as tags. 


EXAMP LES The following example shows how to use the <LITERAL> and <ENDLITERAL> 
tags. 
| <P> I have experimented with my own method for noting questionable 
phrases, by placing <LITERAL><NOTE_PROBLEM><ENDLITERAL> near the 
phrase. 


This example produces the following output: 


I have experimented with my own method for noting questionable phrases, 
by placing <NOTE_PROBLEM> near the phrase. 
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<LITERAL> 


The following example shows how to use the <LITERAL> (literal text) tag. 


2] <P> I’ve experimented with my own method for noting questionable 
phrases, by placing <LITERAL>(<NOTE_PROBLEM>) near the 
phrase. 


This example produces the same output as the first example. 
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<LOWERCASE> 


<LOWERCASE> 


Labels text that you want to appear as lowercase in the final output. 





FORMAT <LOWERCASES (text) 





ARGUMENTS text 


Specifies the text to appear in lowercase. 





related tags ° <UPPERCASE> 





DESCRIPTION _ The <LOWERCASE> tag labels text that you want to appear as lowercase 
in the final output. In your book, you may have a text element, such as 
a heading, that normally appears in uppercase. For example, in some 
doctypes, first-level headings use all uppercase letters. If you need to 
overcome the default case in one of your tags and ensure that the result in 
the final output appears in lowercase, use this tag. 





EXAMPLE The following example shows how to use the <LOWERCASE> tag. Assume 
that the doctype being used causes the <HEAD2> tag to output a heading 
that is in uppercase, no matter what the case of the text passed to it. 


<HEAD2>(HeRe iS aN ExAmP1E oF <LOWERCASE>(lOwErCaSe) tExT) 


The example produces the following output: 
HERE IS AN EXAMPLE OF lowercase TEXT 


The default to uppercase letters causes the heading to be uniformly 
uppercase, with the exception of the text used in the argument to the 
<LOWERCASE> tag. 
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<MARK> 





<MARK> 


Indicates the beginning of new or modified information. 





FORMAT 


<MARK> 





ARGUMENTS 


related tags 


restrictions 


required 
terminator 


None. 





¢ <REVISION> 
¢ <UPDATE_RANGE> 





Valid only in the context of a <REVISION> tag. 


Both the <MARK> and <ENDMARK> tags must be within the code for a 
stacked list (using the <LIST>(stacked) tag) if you want change bars in a 
stacked list. 


<MARK> tags within the arguments to the following tags must be 
terminated within the argument by the <ENDMARK> tag. 


° <APPENDIX>, <CHAPTER>, <EXAMPLE>, <FCMD>, <FIGURE>, <FPARMS>, 
<FOOTNOTE>, <GLOSSARY>, <HEADn>, <REVISION_INFO>, <TABLE>, and 
<TITLE> when used within the context of a <PART_PAGE> tag 


Using <MARK> and <ENDMARK> within the arguments to all these tags, 
(except for <FCMD>, <FPARMS>, <FOOTNOTE>, and <REVISION_INFO>), 
create change bars in the table of contents. 


The following SOFTWARE doctype tags: <COMMAND>, <COMMAND_ 
SECTION>, <ROUTINE>, <ROUTINE_SECTION>, <STATEMENT>, <STATEMENT_ 
SECTION>, <SUBCOMMAND>, <SUBCOMMAND_SECTION_HEAD>, <SDML_ 
TAG>, and <TAG_SECTION> 





<ENDMARK> 


DESCRIPTION 
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The <MARK> tag indicates the beginning of new or modified information. 
The <MARK> tag, along with the <ENDMARK> tag, must be enabled by 
the <REVISION> tag in order to produce vertical bars in the margin 

of the document (and optionally, in the table of contents—see the 
RESTRICTIONS section), as well as in MAIL, TERMINAL, and LINE 
output. 


Make sure to place the <MARK> and <ENDMARK> tags next to the text 
they mark, without preceding or following the text with other tags. The 
text formatter interprets the <MARK> tag based on the last text character 
encountered before the <MARK> tag. 


<MARK> 





EXAMPLE In the following example, the first paragraph is the original and the second 
paragraph is the modified version that shows how to use the <MARK> and 


<ENDMARE> tags. 


<P> 

The following characters are legal in MACRO-11 source programs: 
<LIST> (UNNUMBERED ) 

<LE>The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted to 
uppercase. 

<LE>The digits 0 through 9. 

<LE>The characters period <PARENDCHAR>(.) and dollar sign 
<PARENDCHAR>($). These characters are reserved for use as Digital 
Equipment Corporation system program symbols. 

<ENDLIST> 


<REVISION> 


<P> 

The following characters are legal in MACRO-11 source programs: 
<LIST> (UNNUMBERED ) 

<LE>The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted to 
uppercase. 


<MARK> 

<LE>Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in <REFERENCE>(mcs_app), 

with a list of directives that 

support the MCS. 

<ENDMARK> 


<LE>The digits 0 through 9. 

<LE>The characters period <PARENDCHAR>(.) and dollar sign 
<PARENDCHAR>($). These characters are reserved for use as Digital 
Equipment Corporation system program symbols. 

<ENDLIST> 


The output for the original paragraph and the modified paragraph follows: 
The following characters are legal in MACRO-11 source programs: 


¢ The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted 
to uppercase. 


e The digits 0 through 9. 


¢ The characters period (.) and dollar sign ($). These characters are 
reserved for use as Digital Equipment Corporation system program 
symbols. 


The following characters are legal in MACRO-~11 source programs: 


¢ The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted 
to uppercase. 
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<MARK> 
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Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in Appendix A, with a list of directives 
that support the MCS. 


The digits 0 through 9. 


The characters period (.) and dollar sign ($). These characters are 
reserved for use as Digital Equipment Corporation system program 
symbols. 





<MATH> 


Labels a short mathematical expression or the beginning of an extended 
mathematical example. 





FORMAT math expression 
<MATH>({ DISPLAY/\ symbol name] \ 


ARGUMENTS -_ math expression 


Specifies a mathematical expression that you want to include in the text of 
a sentence or paragraph. 


DISPLAY 
This keyword specifies that a mathematical equation or expression that is 


longer than one line is to be set off from the surrounding text. If you use 
DISPLAY, you must use the <ENDMATH> tag to terminate the display. 


symbol name 

This is an optional argument. It specifies a symbol name by which a 
mathematical equation that is longer than one line is to be referenced. 
If you specify this argument, the equation is assigned a number and the 
number is printed to the right of the equation. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





related tags * <CODE_EXAMPLE> 
¢ <MATH_CHAR> 
© <REFERENCE> 





restrictions You cannot use mathematical examples that are longer than one line in 
the context of a <TABLE> or an <EXAMPLE> tag. 


Invalid in the context of a <HEADn> tag. 
Invalid in the context of a <FOOTNOTE> tag. 
Invalid in the context of a <FORMAT> tag. 


You cannot use tab characters and carriage returns for space in the context 
of a <MATH> tag. 


The set of tags valid within a mathematical expression is limited to those 
listed in the tables in the following DESCRIPTION section. 





required <ENDMATH> —Required if you specify the DISPLAY argument to the 
terminator <MATH> tag. 
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<MATH> 





DESCRIPTION 
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Note: 


Note: 


The <MATH> tag labels a short mathematical expression or the beginning 
of an extended mathematical example. Within an argument to the <MATH> 
tag or within the bounds of the <MATH>(DISPLAY) . . . <ENDMATH> tags, you 
can specify simple or complex mathematical expressions, according to the 
rules outlined below. The context in which you enter text and tags within 
a mathematical expression is severely restricted. 


In a mathematical expression, all formatting is controlled by the text 
processor. When you use the DISPLAY keyword, the output will be offset 
from the surrounding text, but you do not have any control over its 
positioning. Furthermore, blank spaces and carriage returns are ignored; 
the text processor assumes that all text strings are mathematical variable 
names and makes all decisions regarding the output formatting. 


Parentheses 


Most of the tags valid in math do not accept arguments. Parentheses, 
however, are frequently used in mathematical expressions. You must be 
careful, therefore, to use a space between the tag and the parentheses. For 
example: 


<MATH> (A <minus> (B<PLUS>C) ) 


At times, it may be helpful to you to use the <OPAREN> and <CPAREN> 
tags in place of the opening and closing parenthesis in math 
equations. This way, you and the text formatter can determine 
what. you mean to be a literal parenthesis as opposed to the 
opening or closing parenthesis of an argument. 


Simple Expressions 


The following tags are used to indicate simple binary operations. In the 
context of a mathematical expression, you can use either the tag name or 
the function’s symbol. 


<TIMES> ‘i Multiplication 
<PLUS> + Addition 
<MINUS> - Subtraction 
<DIVIDED_BY> / Division 
<EQUALS> 7 Equality 


For example, the following are equivalent: 


<MATH> (total =A+B-C*D/ B&B) 
<MATH> (total <EQUALS> A <PLUS> B <MINUS> C <TIMES> D <DIVIDED_BY> E) 


Both produce the following output: total = A+ B-C*D/E 


Using any nonalphanumeric characters (such as, @, #, $, tabs, and 
so on) other than those specified above in the context of math 
may produce unpredictable results, including errors from the text 
formatter. 


<MATH> 


Operators are evaluated using the normal mathematical rules for 
precedence of operators. You can control the evaluation by using the 
<GROUP> tag, much as you would use parentheses in a mathematical 
expression. Note the use of the <GROUP> tag in the second math expression 
in the following code fragment: 


<MATH> (total = A +B-C*D<OVER>(e) ) 
<P> ‘ 
<MATH> (total = <GROUP>(<GROUP>(A +B-C*D)<OVER>(e)) ) 


This example produces the following output: 
totel=A+B-—C*D 
é 


_ A+B-—C#xD 
total = a 


The effect of the <GROUP> tag is supplied by default for fractional 
expressions when you use the <FRACTION> tag. For example: 


<MATH> (display) ‘ 
total = <FRACTION>(A + B - C * D\E) 
<ENDMATH> 


Variable Names 


The text formatter assumes that variable names are primarily alphabetic 
letters or special characters represented by the <MATH_CHAR> tag. If you 
need to specify any variable names in expressions that contain special 
characters, you must use the <VARIABLE> or <TEXT> tags. For example: 


<MATH> (<variable>(event_flag) = 1) 


If you require multiword variable names, you must use the <SP> tag to 
indicate spacing. For example: 


<MATH> (display) 
<VARIABLE> (SUCCESS<sp>RATE) <equals> 
<group> ( 
<VARIABLE> (TOTAL<SP>HITS) <over>(<VARIABLE>(TOTAL<sp>HITS) <plus> 
<VARIABLE> (TOTAL<sp> MISSES) 
) 

) 
<times> 100 
<ENDMATH> 


This example produces the following output: 


. TOTAL HITS 
Dnt Sener TOTAL HITS +TOTAL MISSES wae 


You can provide special annotation for variable names by using the 
following tags: 


Tag Output 
<BAR_CHAR>(x) Zz 
<DOT_CHAR>(x) & 
<HAT>(xyz) yz 
<HAT_CHAR>(x) Zz 
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<MATH> 
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Tag 


<OVERLINE>(var) 
<TILDE>(xyz) 
<TILDE_CHAR>(x) 
<UNDERLINE>(var) 
<VECTOR>(x) 


Summary of Tags 


Output 


ay is Re 2) es} 
~3 a 
3 al a 


Table 1-1 summarizes the tags that are valid in mathematical expressions. 


Table 1-1 <MATH> Expressions 
Tag 


Operation and Output 





<AMPERSAND> 


<ATOP>(expression) 
<BACKSLASH> 


<CAL-> (letter) 


<CASES> 
<CASE_ROW> 
<ENDCASES> 


<CDOTS> 
<CHOOSE>(expression1\ expression2) 
<DDOTS> 


<DIVIDED_BY> 
<DOTS> 
<DOT_TIMES> 


<EQUALIGN> 
<ELINE> 
<ENDEQUALIGN> 


<EQUALS> 

<FRACTION>(numerator \ denominator) 
<FUNC>(expression) 
<GROUP>(expression) 


Specifies a literal ampersand character 
in a math expression. 


Stacks an expression, as in §. 


Specifies a literal backslash character 
in a math expression. 


Specifies a calligraphic uppercase 
letter, as in A. 


Specifies a case construction. See 
“Matrixes and Cases” in this tag 
description. 


Specifies centered dots, as in--.-. 
Parenthetical notation, as in (¢). 


Specifies diagonal dots, as in -.. 
Division, as in a/b. 

Specifies horizontal dots, as in .... 
Multiplication, as in a- 6. 


Starts an alignment section, so that 
expressions on the right and left side of 
a character (usually an equal sign) are 
balanced. See “Aligning Expressions” 
in this tag description. 


Equality, as in a = b. 
Specifies a fraction, as in 4. 
Specifies a function, as in f(a). 


Provides control over the order of 
operation. See example four in 
the “Examples” section in this tag 
description. 


<MATH> 


Table 1-1 (Cont.) <MATH> Expressions 


Tag 
<INTEGRAL> 


<INTEGRAL_LIMITS> 


<INTEGRAL_NOLIMITS> 


<MATRIX> 
<MATRIX_ROW> 
<ENDMATRIX> 


<MINUS> 
<MOD> 
<LBAR> 


<LBRACE> 


<LBRACKET> 


<LCEIL> 


<LFLOOR> 


<LPAREN> 


<OVER>(expression) 
<PI> 

<PLUS> 
<PMOD>(expression) 
<PROD> 


Operation and Output 

£ 
Specifies an integral, as in Pe See 
“Operators With and Without Limits” in 
this tag description. 


Specifies an integral that places 
superscripts and subscripts above and 
below the sign, rather than to the right. 
See “Operators With and Without 
Limits” in this tag description. 


Specifies an integral that places 
superscripts and subscripts to the 
right of the sign, rather than above 
and below. See “Operators With and 
Without Limits” in this tag description. 


Specifies a matrix. See “Matrixes and 
Cases” in this tag description. 


Minus, as in a — b. 
Modulo, as in n mod p. 
Begins an expression delimited 


with vertical bars. See “Delimited 
Expressions” in this tag description. 


Begins an expression delimited 
with curly braces. See “Delimited 
Expressions” in this tag description. 


Begins an expression delimited with 
square brackets. See “Delimited 
Expressions” in this tag description. 


Begins an expression delimited with 
ceiling characters ([). See “Delimited 
Expressions” in this tag description. 


Begins an expression delimited with 
floor characters (|). See “Delimited 
Expressions” in this tag description. 


Begins an expression delimited 
with parentheses. See “Delimited 
Expressions” in this tag description. 


Division, as in ¢. 

The pi character, 7. 

Plus, as in a+ 6. 

Parenthetical mod, asin @ (mod p). 


=z 
Specifies a product, as in [[¢. See 
“Operators With and Without Limits” in 
this tag description. 
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Table 1-1 (Cont.) <MATH> Expressions 


Tag 
<PROD_LIMITS> 


<PROD_NOLIMITS> 


<RBAR> 


<RBRACE> 


<RBRACKET> 


<RCEIL> 


<RFLOOR> 


<RPAREN> 


<SP> 


<SQRT>(expression) 
<SUBSCRIPT>(expression) 
<SUM> 


<SUM_LIMITS> 


<SUM_NOLIMITS> 


Operation and Output 


Specifies a product that places 
superscripts and subscripts above 
and below the sign, rather than to 
the right. See “Operators With and 
Without Limits” in this tag description. 


Specifies a product that places 
superscripts and subscripts to the 
right of the sign, rather than above 
and below. See “Operators With and 
Without Limits” in this tag description. 


Ends an expression delimited 
with vertical bars. See “Delimited 
Expressions” in this tag description. 


Ends an expression delimited with curly 
braces. See “Delimited Expressions” 
in this tag description. 


Ends an expression delimited with 
square brackets. See “Delimited 
Expressions” in this tag description. 


Ends an expression delimited with 
ceiling characters (]). See “Delimited 
Expressions” in this tag description. 


Ends an expression delimited with 
floor characters (|). See “Delimited 
Expressions” in this tag description. 


Ends an expression delimited 
with parentheses. See “Delimited 
Expressions” in this tag description. 


Provides space in a variable name or 
expression. 


The square root, as in ,/a. 
Subscription, as in ap. 


Specifies summation, as in a> b. See 
“Operators With and Without Limits” in 
this tag description. 


Specifies summation that places 
superscripts and subscripts above and 
below the sign, rather than to the right. 
See “Operators With and Without 
Limits” in this tag description. 


Specifies summation that places 
superscripts and subscripts to the 
right of the sign, rather than above 
and below. See “Operators With and 
Without Limits” in this tag description. 


<MATH> 


Table 1-1 (Cont.) <MATH> Expressions 





Tag Operation and Output 

<SUPERSCRIPT>(expression) Exponentiation, as in a’. See 
“Operators With and Without Limits” in 
this tag description. 

<TEXT> Specifies text in a math expression. 

<TIMES> Multiplication, as in a * b. 

<TO> Indicates progression, as in 1 — 10. 

<VARIABLE> Specifies a variable name that contains 
nonalphanumeric characters. 

<VDOTS> Specifies vertical dots, as in :. 

<VECTOR>(var) A vector, as in 2. 

<X_TIMES> Multiplication, as in @ x 6. 


Operators With and Without Limits 


When you specify <SUBSCRIPT> and <SUPERSCRIPT> tags, the subscript or 
superscript applies to the immediately preceding variable or expression. 
You can specify these tags in any order, as shown in the following example: 


<MATH> (a<subscript> (2) <superscript>(n-1) ) 


This example produces the following output: an 


In extended mathematical expressions, the <SUPERSCRIPT> and 
<SUBSCRIPT> tags produce differing results in conjunction with the 
<INTEGRAL>, <PROD>, and <SUM> tags and their complementary tags— 
<INTEGRAL_LIMITS> and <INTEGRAL_NOLIMITS>, <PROD_LIMITS> and <PROD_ 
NOLIMITS>, and <SUM_LIMITS> and <SUM_NOLIMITS>. 


The <INTEGRAL>, <PROD>, and <SUM> tags place their subscripts and 
superscripts with regard to whether the tags are used in math text mode 
(used as an argument to the <MATH> tag) or in math display mode (used 
between the <MATH>(DISPLAY) and <ENDMATH> tags). 


In math text mode, the <INTEGRAL>, <PROD>, and <SUM> tags all place the 
superscript and subscript to the right. Code these tags as follows: 


<MATH> (<integral><subscript>(n=1)<superscript>( <pi><over>(2) ) <sp> ) 
<MATH?> ( <prod><subscript>(n=1)<superscript>( <pi><over>(2) ) <sp> ) 
<math> ( <sum><subscript>(n=1)<superscript>( <pi><over>(2) ) ) 
r ris 7. 
: : - f2 2 2 
This example produces the following output: f?, [7.4 Sofa 


In math display mode, the <PROD> and <SUM> tags place the superscript 
and subscript above and below their respective signs; however, the 
<INTEGRAL> tag places superscripts and subscripts to the right. Code 
these tags as follows: 


<MATH> (display) 


<integral><subscript> (n=1) <superscript> ( <pi><over> (2) ) <sp> 
<prod><subscript>(n=1)<superscript>( <pi><over>(2) ) <sp> 
<sum><subscript>(n=1)<superscript>( <pi><over>(2) ) 
<ENDMATH> 
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<MATH> 


1-170 


This example produces the following output: 


x 


[2.0 


n=1 n=1 


Ms 


The <INTEGRAL_NOLIMITS>, <PROD_NOLIMITS>, and <SUM_NOLIMITS> tags 

always place the subscripts and superscripts to the right of the signs, 

regardless of the math mode. Code these tags as follows: 

<MATH> (display) 

<integral_nolimits><subscript>(n=1)<superscript>( <pi><over>(2) ) <sp> 
<prod_nolimits><subscript>(n=1)<superscript>( <pi><over>(2) ) <sp> 


<sum_nolimits><subscript>(n=1)<superscript>( <pi><over>(2) ) 
<ENDMATH> 


This example produces the following output: 


i Itt, Dae 


The <INTEGRAL_LIMITS>, <PROD_LIMITS>, and <SUM_LIMITS> tags always 

place the subscripts and superscripts above and below the signs, regardless 

of the math mode. Code these tags as follows: 

<MATH> (display) 

<integral_limits><subscript>(n=1)<superscript>( <pi><over>(2) ) <sp> 
<prod_limits><subscript>(n=1)<superscript>( <pi><over>(2) ) <sp> 


<sum_limits><subscript>(n=1)<superscript>( <pi><over>(2) ) 
<ENDMATH> 


This example produces the following output: 


Mathematical Functions 


In addition to the operations and special functions listed in Table 1-1, 
you can specify mathematical functions using any of the tags listed in 
Table 1-2. These tags all let you specify the tag with or without an 
argument. If you specify an argument, place it in parentheses following 
the function name. For example: 


<MATH> (<SIN> (qd) ) 


This produces: sin(d). 


<MATH> 


Table 1-2 Tags for Mathematical Functions 








Tag Function 
<ARCCOS> arccos 
<ARCSIN> arcsin 
<ARCTAN> arctan 
<ARG> arg 
<COS> cos 
<COSH> cosh 
<COT> cot 

~ <COTH> coth 
<CSC> csc. 
<DEG> | | deg 
<DET> det 
<DIM> dim 
<EXP> exp 
<GCD> ged 
<HOM> hom 
<INF> inf 
<KER> ker 
<LG> lg 
<LIM> lim 
<LIMINF> lim inf 
<LIMSUP> lim sup 
<LN> In 
<LOG> log 
<MAX> max 
<MIN> min 
<MOD> mod 
<PMOD> (mod n)' 
<PR> Pr 
<SEC> sec 
<SIN> sin 
<SINH> sinh 
<SUP> sup 
<TAN> tan 
<TANH> tanh 





‘Using the <PMOD> tag adds a space before the output of the tag, which is why the 
output of the tag is not aligned in the “Function” column of this table. 





An example of using some of the tags from the previous table follows: 


1-171 © 


<MATH> 
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<LIST> (UNNUMBERED) 


<le><math> ( 

<sin>2<math_char> (theta) 
<equals>2<sin><math_char> (theta) <cos><math_char> (theta) 

) 


<le><math> ( ; 
O(n <log>n <log><log>n) 
) 


<le><math> ( 
<pr>(X >x)= <exp>(-x/<math_char> (mv) ) 
) 


<le><math> ( . 
<max><subscript> (1<math_char>(geq) n<math_char> (geq) m) 
<log><subscript>(2)P<subscript> (n) 

) 


<le><math> ( 
<lim><subscript> (x<to>0) <group> ( 

<sin>x<over> (x) ) 
<equals>1 


) 
<endmath> 


<ENDLIST> 
These examples produce the following output: 
¢ sin 26 = 2sin 0 cos 8 

* O(nlog nlog log n) 

© = Pr(X > z) = exp(—z/p) 

* mMaxi>n>m loge Pr 

* lim, o 22 =1 





Aligning Expressions 


To align math expressions on the right and left side of an alignment point 
(usually an equal sign) so that the expressions are balanced, use the 
following tags: 


* <EQUALIGN>—begins an alignment section and enables the <ELINE> tag. 


¢ <ELINE>—takes an argument representing the left and right side of the 
equation. The first character in the second argument is the character 
upon which the alignment is based. 


¢ <ENDEQUALIGN>—terminates the alignment section. 


For example: 


<math> 
<EQALIGN> 
<eline>(H(f£)\= 


<GROUP> (<LBAR><GROUP> (<FRACTION> (E (x) \E(0) ) )<RBAR> 
<SUBSCRIPT> (E (0) =e<SUPERSCRIPT> (j<MATH_CHAR> (OMEGA) t) )) ) 


<Eline> (\=<GROUP> (e<SUPERSCRIPT> (~<MATH_CHAR> (GAMMA) x) ) ) 
<endeqalign> 
<ENDMATH> 


<MATH> 


This example produces the following output: 


HN) = | Bia 


= e = 











E(0)=esvt 


Delimited Expressions 


To produce delimited expressions in mathematics, you must use one of the 
following pairs of tags: 


° <LBAR> and <RBAR>—for opening and closing vertical bars 

¢ <LBRACE> and <RBRACE>—for opening and closing curly braces 

¢ <LBRACKET> and <RBRACKET>—for opening and closing square brackets 
¢ <LCEIL> and <RCEIL>—for opening and closing ceiling delimiters 

¢ <LFLOOR> and <RFLOOR>—for opening and closing floor delimiters 

e <LPAREN> and <RPAREN>—for opening and closing parentheses 


The text formatter automatically assumes that text within these pairs is 
to be grouped, and it sizes the delimiters automatically. 


For example: 


<MATH> (display) 
<group> ( 
C<subscript> (dg) 
, , 
<fraction> (<math_char> (partial) Q<subscript>(d)\ 
<math_char> (partial) V<subscript> (g) ) 


-C<subscript> (oxt) 


[0.5 
+ 
<lparen>f<subscript>(0) DVG - 
<group> (2f<subscript>(0) V<subscript> (com) <over> (f<subscript> (1) ) 
) 
<rparen> 
<group>(1 <over>(f<subscript>(1)<superscript> (2) )) 
] 


<ENDMATH> 


This example produces the following output: 


fe) 2foV, 1 
Cin = Si! = —Cozt oss (foDve - vores A 
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-_<MATH> 
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Matrixes and Cases 


You can construct matrixes and case constructs using the formats provided | 
with <MATRIX> and <CASES> tags. 


The <MATRIX> tag has the following format: 


BRACES 
<MATRIX>( | BRACKETS ) 
VERTICAL_RULE 


The keywords BRACES, BRACKETS, and VERTICAL_RULE override the 
default matrix delimiter, parentheses. 


When you construct a matrix, you must specify each row in the matrix _ 
using the <MATRIX_ROW> tag. You can specify a maximum of nine columns 
for the row. Terminate the matrix with the <ENDMATRIX> tag. For example: 


<matrix> (brackets) 
<matrix_row> (A) 
<matrix_row>(B) 
<matrix_row>(C) 
<matrix_row>(D) 
<endmatrix> 


This simple, one-column matrix produces the following output: 
A 


B 
C 
D 


A more complex example shows how to code a multicolumn matrix: 


<math> (display) 
<det><matrix>(vertical_rule) 
<matrix _ fous (e<subseripe> (0) \eeubscr pes (ih \ 
c<subscript> (2) \<dots>\c<subscript> (n) ) 
<matrix_row>(c<subscript>(1) \c<subscript> (2) \ 
c<subscript> (3) \<dots>\c<subscript> (n+1) ) 
<matrix_row> (c<subscript> (2) \c<subscript> (3) \ 
c<subscript> (4) \<dots>\c<subscript> (n+2) ) 
<matrix_row>(<vdots>\<vdots>\<vdots>\<vdots>) 
<matrix_row>(c<subscript>(n) \c<subscript>(n+1) \ 
CceMbaGE sper (rte) \sdobe7se<eubscripes (20) 
<endmatrix> > 0. 
<endmath> 


This produces the following output: 


co cy co eee Cn 
Cl ca c3 eee Cn+1 
Cn Cntl Cn+2 +++ COn 


<MATH> 


The following example shows how to code a multicolumn matrix with 
fractions: 


<math> (display) 

<matrix> (brackets) 
<matrix_row>(4<over> (4<minus>6) \2<over> (6<minus>4) ) 
<matrix_row> (3<over> (6<minus>4) \l<over> (4<minus>6) ) 
<endmatrix> = 

<matrix> (brackets) 
<matrix_row> (4<over> (<minus>2) \2<over> (2) ) 
<matrix_row> (3<over> (2) \l<over>(<minus>2) ) 
<endmatrix> = 

<matrix> (brackets) 

<matrix_row>(<minus>2\<sp>1) 
<matrix_row>(1.5\<minus>.5) 

<endmatrix> 

<endmath> 


This produces the following output: 
4 2 4 2 
fs it|- [7 tl-[2 4 
3 1 | |}32 A] [15 -.5 
6-4 7-6 2 <3 


The <CASES> tag is similar to the <MATRIX> tag, but it produces only a large 
left-hand brace; there is no closing delimiter. The following example shows 
how to use the <CASES> tag and its related tags: 


<MATH> (display) 

<cases> 
<case_row>(1/3\if\0> x\;) 
<case_row>(2/3\if\3< x\;) 
<case_row>(0\elsewhere.) 
<endcases> 

<ENDMATH> 


This example produces the following output: 
| 1/3 ifO0>a; 


2/3 if 3 <q; 
0 elsewhere. 





EXAMPLES The following example illustrates a simple mathematical expression used 
in the context of a sentence. 


Hi The area of a circle is calculated using the 
formula <MATH>(a<equals><pi>r<superscript>(2)). 


This example produces the following output: 


The circumference of a circle is calculated using the formula c = rr?. 


The following example shows how to use the <MATH>(DISPLAY) tag. Note 
that the parenthetical expression following the first <MINUS> tag must 
have a space in front of it; otherwise, the expression will be interpreted as 
an argument to the <MINUS> tag. 
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<MATH> 


2) <MATH> (DISPLAY) 
vsize <equals> psize <minus>(<minus>topglue) <minus> topdepth <minus> footerglue 
<ENDMATH> 


This example produces the following output: 


vsize = psize — (—topglue) — topdepth — footerglue 


The following example shows how to use the <MATH> tag in a list. 


3 <LIST> (NUMBERED) 
<le><MATH> (1<over> (2) ) 
<le><MATH> (n+1<over> (3) ) 
<le><MATH> (<choose> (N+1\3) ) 
<le><MATH> (<sum><subscript> (n=1) <superscript> (3) Z<subscript>(n)<superscript> (2) ) 
<ENDLIST> 


This example produces the following output: 


1 3 

2 

3 (%3") 

4 34 


The following example illustrates how to use the <GROUP> tag to indicate 
the order of operation. 


<MATH> (DISPLAY) 
<GROUP> ( 
a<over> (x<plus>y<superscript> (3) ) 
) 
<EQUALS> <SQRT>(<times><pi>) 
<ENDMATH> 


This example produces the following output: 


a = lay 


a+ y? 





Note what the output would be if you did not use the <GROUP> tag: 


a 
a+ y3 = fen 
In the following example, the characters representing the mathematical 
operations are used directly. 
<MATH>(total =A+B-C*D/ E) 


This example produces the following output: 
total = A+ B-—C#D/E. 
Note that this is equivalent to the following: 


<MATH> (total <EQUALS> A <PLUS> B <MINUS> C <TIMES> D <DIVIDED_BY> E) 


The following example shows how to use the <MATH> tag to generate true 
minus signs in your SDML files. 
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<MATH> 


<MATH>(--) This begins a comment line. 


This example produces the following output: 


——This begins a comment line. 


The following example shows how to use the <REFERENCE> tag to refer to 
an equation. 

<MATH> (DISPLAY\math_equation) 

math = numbers + letters 

<ENDMATH> 

<p>As <REFERENCE>(math_equation) shows, the relationship between 

letters and math must include numbers. 


This example produces the following output: 


math = numbers + letters (1—1) 


As (1-1) shows, the relationship between letters and math must include 
numbers. 
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<MATH_CHAR> 


<MATH_ CHAR> 


Creates a special mathematical symbol. 





FORMAT 


<MATH_CHARs> (keyword) 





ARGUMENTS 


related tags 


restrictions 


keyword : 
Indicates the special symbol you want to access. The keywords, and the 
symbols they produce, are listed in Table 1-3. 





© <MATH> 
e <MCS> 
e <SPECIAL_CHAR> 





Invalid in headings, that is, within an argument to a <HEADn> tag. 


The characters produced using the <MATH_CHAR> tag are sized only for 
normal text sizes. Therefore, these characters do not produce good visual 
results in text that requires a different font size, like header levels, text in 
the OVERHEADS doctype, and so on. 


DESCRIPTION 
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The <MATH_CHAR> tag creates a special mathematical symbol. Table 1-3 
summarizes the keywords and special symbols you can access with the 
<MATH_CHAR> tag. 

Table 1-3. <MATH_CHAR> Keywords and Symbols 


Keyword Symbol 





The Greek Letters 





ALPHA a 
BETA B 
CHI x 
DELTA 6 
EPSILON € 

ETA n 
GAMMA a 
lIOTA b 

KAPPA K 
LAMBDA A 
MU fs 


<MATH_CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 


Keyword 
The Greek Letters 


NU 
OMEGA 
OMICRON 
PHI 

PI 

PSI 

RHO 
SIGMA 
TAU 
THETA 
UPSILON 
VAREPSILON 
VARPHI 
VARPI 
VARRHO 
VARSIGMA 
VARTHETA 
Xl 

ZETA 


The Uppercase Greek Letters 


Symbol 


qv @rayeeoe vy 


~ mr or SF 7g FC 7 SC FN 





UPPERCASE_ALPHA 
UPPERCASE_BETA 
UPPERCASE_CHI 
UPPERCASE_DELTA 
UPPERCASE_EPSILON 
UPPERCASE_ETA 
UPPERCASE_GAMMA 
UPPERCASE_IOTA 
UPPERCASE_KAPPA 
UPPERCASE_LAMBDA 
UPPERCASE_MU 
UPPERCASE_NU 
UPPERCASE_OMEGA 
UPPERCASE_OMICRON 
UPPERCASE_PHI 


© ON 2ZEeBRAT NTSB KD Pp 
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<MATH_CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 
Keyword . Symbol 
The Uppercase Greek Letters 


UPPERCASE_PI 
UPPERCASE_PSI 
UPPERCASE_RHO 
UPPERCASE_SIGMA 
UPPERCASE_TAU 
UPPERCASE_THETA 
UPPERCASE_UPSILON 
UPPERCASE_XI 
UPPERCASE_ZETA 


Nm 8 OHM Ve 


The Ordinal Operators 





ALEPH 
ANGLE 
BACKSLASH 
BOT 
CLUBSUIT 
DIAMONDSUIT 
DOUBLE_VERT 
ELL 
EMPTYSET 
EXISTS 

FLAT 

FORALL 
HBAR 
HEARTSUIT 
IM 

IMATH 

INFTY 

JMATH 
NABLA 
NATURAL 
NEG 

PARTIAL 
PRIME 

RE 

SHARP 


Q Qtr <t TruSsee>— o> wPE-E-- KR & 


a a Una a as 


Fe BS 
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<MATH_CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 
Keyword Symbol | 
The Ordinal Operators 
SPADESUIT | 
SURD 

TOP 


TRIANGLE 
WP 


SDP4d<c? 


Binary Operators 
AMALG 

AST 

BIGCIRC 
BIGTRIANGLEDOWN 
BIGTRIANGLEUP 
BULLET 

CAP 

CDOT 

CIRC 

CUP 

DAGGER 
DDAGGER 
DIAMOND 

DIV 

MP 

ODOT 

OMINUS 

OPLUS 
OSLASH 
OTIMES 





>PdIO* F 


» 


| Oo + + CO 


® 089 @ 0048 
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<MATH_CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 
Keyword Symbol 
Binary Operators 


PM 

SETMINUS 
SQCAP 

SQCUP 

STAR 

TIMES 
TRIANGLELEFT 
TRIANGLERIGHT 
UPLUS 

VEE 

WEDGE 

WR 


€vax*teodg—4# 


~ >< 


Relational Operators 


APPROX 
ASYMP 
BOWTIE 
CONG 
DASHV 
DOTEQ 
EQUIV 
FROWN 
GEQ 

GG 

IN 

LL 

LEQ 

MID 
MODELS 

NI 
NOT_APPROX 
NOT_ASYMP 
NOT_CONG 
NOT_EQUIV 
NOT_EQ 
NOT_GEQ 


2 


Xe 


Ik + IR X 


) 


MRM RK RUT TA AM Y¥ IV 
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<MATH_CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 


Keyword 


Relational Operators 


NOT_GT 
NOT_LEQ 
NOT_LT 
NOT_PRECEQ 
NOT_PREC 
NOT_SIMEQ 
NOT_SIM 
NOT_SQSUBSETEQ 
NOT_SQSUPSETEQ 
NOT_SUBSET 
NOTSUBSETEQ 
NOT_SUCCEQ 
NOT_SUCC 
NOT_SUPSETEQ 
NOT_SUPSET 
PARALLEL 
PERP 

PRECEQ 

PREC 

PROPTO 
SIMEQ 

SIM 

SMILE 
SQSUBSETEQ 
SQSUPSETEQ 
SUBSETEQ 
SUBSET 
SUCCEQ 

SUCC 
SUPSETEQ 
SUPSET 
VDASH 


Symbol 


eH X YA AWN RRAKRY,AM Y 


RRA Wk = 


2 


TUW Y IY A IN WIN ¢ 
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<MATH_CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 
Keyword Symbol 
Arrows 


DOUBLE_DOWNARROW 
DOUBLE_LEFTARROW 
DOUBLE_LEFTRIGHTARROW 
DOUBLE_LONGLEFTARROW 
DOUBLE_LONGLEFTRIGHTARROW 
DOUBLE_LONGRIGHTARROW 
DOUBLE_RIGHTARROW 
DOUBLE_UPARROW 
DOUBLE_UPDOWNARROW 
DOWNARROW 
HOOKLEFTARROW 
HOOKRIGHTARROW 
LEFTARROW 
LEFTHARPOONDOWN 
LEFTHARPOONUP 
LEFTRIGHTARROW 
LONGLEFTARROW 
LONGLEFTRIGHTARROW 
LONGMAPSTO 
LONGRIGHTARROW 
MAPSTO 

NEARROW 

NWARROW 

RIGHTARROW 
RIGHTHARPOONDOWN 
RIGHTHARPOONUP 
RIGHTLEFTHARPOONS 
SEARROW 

SWARROW 

UPARROW 

UPDOWNARROW 


pos pes ee ANS are Ral Uys he ae we als ea ee rea a Ih a 
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<MATH_CHAR> 


Table 1-3 (Cont.) <MATH_CHAR> Keywords and Symbols 
Keyword Symbol 
Delimiters 


LANGLE 
RANGLE 
LBRACE 
RBRACE 
LBRACK 
RBRACK 
LCEIL 

RCEIL 

LFLOOR 
RFLOOR 





EXAMPLE The following example lists math expressions using the <MATH_CHAR> tag. 


<LIST> (SIMPLE) 

<le><MATH> (x=y>z) 

<le><MATH> (x:=y) 

<le><MATH> (x<math_char> (leq) y<math_char>(not_eq) z) 
<le><MATH> (x<math_char> (sim) y<math_char>(simeq) z) 
<le><MATH> (x<math_char> (equiv) y<math_char>(not_equiv) z) 
<le><MATH> (x<math_char> (subset) y<math_char> (subseteq) z) 
<ENDLIST> 


This example produces the following output: 
Z=y>z2 
zi=y 
LLyFz 
Lry~rz 


L=yFz 
zCcyCz 
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<MCS> 


<MCS> 


Labels a character in the Digital Multinational Character Set. 





FORMAT <MCS> (character) 





ARGUMENTS ~ character 
Specifies the character you want. The character may be any one of the 
following: 
Argument Character 


spanish_inverted_exclamation 


i 
cents ¢ 
british_pound £ 
japanese_yen ¥ 
section_sign § 
general_currency on 
copyright © 
feminine_ordinal a 
double_open_angle_brackets « 
degree : 
plus_or_minus cy 
superscript2 7 
superscripts 3 
micro i) 
pilcrow q 
raised_period 
superscript : 
masculine_ordinal @ 
double_close_angle_brackets » 
one_fourth % 
one_half Ye 
spanish_inverted_question rp 
cap_a_grave A 
cap_a_acute A 
cap_a_circumflex A 
cap_a_tilde A 
cap_a_umlaut A 
cap_a_ring A 
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Argument 


<MCS> 


Character 





cap_ae 
cap_c_cedilla 
-cap_e_grave 
cap_e_acute 
cap_e_circumflex 
cap_e_umlaut 
cap_i_grave 
cap_i_acute 
cap_i_circumflex 
cap_i_umlaut 
cap_n_tilde 
cap_o_grave 
cap_o_acute 
cap_o_ circumflex 
cap_o_tilde 
cap_o_umlaut 
cap_oe 
cap_o_slash 
cap_u_grave 
cap_u_acute 
cap_u_circumflex 
cap_u_umiaut 
cap_y_umlaut 
german_ss 
small_a_grave. 
small_a_acute 
small_a_circumflex 
small_a_tilde 
small_a_umlaut 
smail_a_ring 
small_ae 
small_c_cedilla 
small_e_grave 
small_e_acute 
small_e_circumflex 
small_e_umlaut 
small_i_grave 
small_i_acute 
small_i_circumflex 


— —- — @ @ OD OW 0 8 M> = A ooaowranrK<coaocaRgoooeooeat Vr TTY mmmmo 
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<MCS> 


Argument Character 





small_i_umlaut 
small_n_tilde 
small_o_grave 
small_o_acute 
small_o_circumflex 
smaill_o_tiide 
small_o_umlaut 
small_oe 
small_o_slash 
small_u_grave 
small_u_acute 
small_u_circumflex 
small_u_umlaut 


< Cc & Cs & & 8 o-oo & O&O O&O S 


smail_y_umlaut 





related tags ¢ <MATH_CHAR> 
¢ <SPECIAL_CHAR> 





restrictions Invalid in the context of a <MATH> tag. 


DESCRIPTION The <MCs> tag labels a character in the Digital Multinational Character 
. . Set. Use this tag when the terminal you are using does not accept or 
display these special characters. 


EXAMPLE The following example shows how to use the <MCS> tag. 


<P>The Digital Multinational Character Set includes the currency sign 
for the Japanese yen (<MCS>(japanese_yen)). 


This example produces the following output: 


The Digital Multinational Character Set includes the currency sign for the 
Japanese yen (¥). 
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<NESTED_TABLE_BREAK> 


<NESTED TABLE BREAK> 





Marks a place where a nested table may be broken across pages. 


FORMAT <NESTED TABLE_BREAK> 








ARGUMENTS ~ None. 





related tags ° <TABLE> 
e = 2TABLE_FILE> 





restrictions Valid only within a nested table. 
Invalid between paragraphs in a single table row. 


Breakpoints for long tables nested inside multipage tables have the 
following limitations: 


¢ The first level table must not use the KEEP argument in the <TABLE_ 
ATTRIBUTES> tag. . 


¢ The first level table must only have two or three columns, which you 
set up using the <TABLE_SETUP> tag. 


DESCRIPTION The <NESTED_TABLE_BREAK> tag marks a place where a nested table may 
. e broken across pages. A nested table is a table that is coded within 
another table. You create a nested table by placing the appropriate table 
tags within an argument to the <TABLE_ROW> tag of the outer table. Place 
the <NESTED_TABLE_BREAK> tag between table rows of a nested table. This 
marks a place that the nested table may be broken across pages. This tag 
has no effect for Bookreader output. 


If you place a <NESTED_TABLE_BREAK> tag in a nested table that contains 
headings, the headings are not repeated on subsequent pages. Also, a rule 
may be output at the point that you include the <NESTED_TABLE_BREAK> 
tag, thereby appearing to end the nested table that continues on the next 


page. 
EXAMPL The following example shows how to use the <NESTED_TABLE_BREAK> tag. 
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<NESTED_TABLE_BREAK> 


<TABLE> (Table Caption\tab_log_ name) 
<TABLE _SETUP>(2\10) 
<TABLE_HEADS> (First Head\Second Head) 
<TABLE_ROW> (Item Here\Definition for Item here.) 

<TABLE ROW>(Item Here\Definition that tells about 
<COMMENT> (*nested table begins*) 


) 


<TABLE> 
<TABLE_SETUP>(2\15) 
<TABLE_ROW> (Item\Text 


<TABLE_ROW> (Item\Text 
<TABLE_ROW> (Item\Text 
<NESTED_TABLE_BREAK> 
<TABLE_ROW> (Item\Text 


<TABLE_ROW> (Item\Text 
<NESTED_TABLE_BREAK> 
<TABLE_ROW> (Item\Text 


<TABLE_ROW> (Item\Text 


. 


<TABLE_ROW> (Item Here\Definition for Item 


<TABLE ROW>(Item\Text 


of 
of 


of 
of 


of 


of 


of 


of 


item 
item 


item 
item 


item 


item 


item 


item 


description 
description 


description 
description 


description 


description 


description 


description 


<TABLE_ROW> (Item Here\Definition for Item 


<ENDTABLE> 


<COMMENT> (*nested table ends*) 


<TABLE_ROW> (Item Here\Definition for Item here.) 
<TABLE_ROW> (Item Here\Definition for Item here.) 
<TABLE _ROW>(Item Here\Definition for Item here.) 
<ENDTABLE> 
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nested table. 


here) 
here) 


here) 
here) 


here) 


here) 


here) 
here) 


here.) 
here.) 


<NEWTERM> 


<NEWTERM> 


Labels a term introduced into the text for the first time. The term is italicized 
in output. 





FORMAT <NEWTERM>(term) 





ARGUMENTS _ term 


Specifies the new term you just introduced. 





related tags ° <KEYWORD> 
¢ ~=<VARIABLE> 





restrictions Invalid in the context of a <MATH> tag. 





DESCRIPTION The <NEWTERM> tag labels a term introduced into the text for the first 
time. The term is italicized in output. 





EXAMPLE The following example shows how to use the <NEWTERM> tag. 


<P>To begin a session at the terminal, you must first <NEWTERM>(log in). 
Logging in consists of identifying yourself as 
an authorized user. 


This example produces the following output: 


To begin a session at the terminal, you must first log in. Logging in 
consists of identifying yourself as an authorized user. 
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<NOTE> 


<NOTE> 


Labels a note, caution, warning, or some other portion of text that you want to 
draw aitention to. 





FORMAT <NOTE> (note text) 
or 
<NOTE>/(heading text)] 
note text 


<ENDNOTE> 





ARGUMENTS heading text 


Specifies text for a heading other than the default heading “Note:”. 


note text 
Specifies the text of the note. A paragraph is implied here, so do not use a 
<P> tag. 





restrictions Do not use this tag immediately after a <SPAN> tag within a table. 
Invalid in the context of a <FOOTNOTE> tag. 





required <ENDNOTE> —Required if you do not specify the note text argument to the 
terminator <NOTE> tag. 


DESCRIPTION _ The <NOTE> tag labels a note, caution, warning, or some other portion of 
text that you want to draw attention to. A note is formatted differently 
depending on the doctype. 


EXAMPLE The following example shows how to use the <NOTE> tag. 


<NOTE> (Caution) You should abort the system generation command 
procedure only after Phase 1 has completed processing. 
<ENDNOTE> 


This example produces the following output: 
Caution: You should abort the system generation command procedure only 


after Phase 1 has completed processing. 
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<OPAREN> 


<OPAREN> 


Supplies an opening parenthesis anywhere in your file. You must use this tag, 
however, to specify an opening parenthesis within an argument to a tag, so 
that the opening parenthesis is not interpreted as the opening parenthesis of 
the tag’s argument. 





FORMAT <OPAREN> 





ARGUMENTS None. 





related tags © The following tags label other characters that you must tag when they 
occur in an argument to a tag: 


<AMPERSAND> 

<BACKSLASH> 

<CPAREN>—required only if there is no opening parenthesis 
<VBAR> 





DESCRIPTION _ The <OPAREN> tag supplies an opening parenthesis anywhere in your file. 
You must use this tag, however, to specify a opening parenthesis within an 
argument to a tag, so that the opening parenthesis is not interpreted as 
the opening parenthesis of the tag’s argument. 


Using the tag, then, is only beneficial (in terms of keystrokes and control 
of the output) as an unmatched opening parenthesis in an argument to 
a tag. An unmatched parenthesis in an argument can cause errors when 
processed, because parentheses are used to determine the beginning and 
ending of an argument list. 


SR aaa NE LE a NN ay OSE a a ee 
EXAMPLE The following example shows how to use the <OPAREN> tag. 


<SUBHEAD1>(Using an Opening Parenthesis <PARENDCHAR> 
(<OPAREN>) in an Argument to a Tag\oparen) 


This example produces the following output: 


Using an Opening Parenthesis (() in an Argument to a Tag 
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<ORDER_NUMBER> 


<ORDER NUMBER> 


Labels the order number or part number that appears on the title page of a 
book. 





FORMAT <ORDER_NUMBER> (number) 





ARGUMENTS number 


Specifies the order number for the book. 





restrictions Valid only in the context of a <TITLE_PAGE> tag. 


DESCRIPTION _ The <ORDER_NUMBER> tag labels the order number or part number that 
appears on the title page of a book. This tag has no effect for Bookreader 


output. 





EXAMPLE See the example in the discussion of the <FRONT_MATTER> tag. 


<P> 


<P> 


Marks the beginning of a new paragraph. 


FORMAT <P> 


ARGUMENTS Nore. 





related tags * <CENTER_LINE> 
° =6<CP> 
° = 6<LINE> 


¢ <RIGHT_LINE> 


DESCRIPTION _ The <P> tag marks a new paragraph. An internal counter keeps track of 
the context in which the new paragraph begins. This allows you to freely 
use <P> tags inside lists and in other contexts where you want to start a 
new paragraph, while maintaining the same logical level of discussion. 


A <P> tag is expected after every heading. If you do not immediately start 
a new paragraph after a heading, you must label the beginning of another 
text element, such as a list. 


A <P> tag also specifies that the text that follows it is an online chunk. 
If you code an index entry within the paragraph, when you click on that 
entry in the Bookreader’s index, the paragraph in which you coded the 
entry appears. 


EXAMPLES The following example shows how to use the <P> tag. 


{ <P> 

a Here is a sentence or two in a paragraph. The following paragraph 
will show the <TAG>(P) tag at work separating paragraphs. 
<P>Here is the second paragraph so that you can observe the relationship 
it has to the first. 


This example produces the following output: 


Here is a sentence or two in a paragraph. The following paragraph will 
show the <P> tag at work separating paragraphs. 


Here is the second paragraph so that you can observe the relationship it 
has to the first. . 
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<P> 


The following example shows how to use a <P> tag within a list. 


<list> (unnumbered) 

<le>Oranges 
<le>Apples 
<p>Note that there are several types of apples<hellipsis> 
<le>Bananas 
<endlist> 

This example produces the following output: 

e Oranges 

e Apples 

Note that there are several types of apples ... 


e Bananas 
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<PAGE> 





<PAGE> 


Breaks a page of text, forcing the text that follows the tag to begin on a new 
page. 


FORMAT EVEN \) 
<PAGESI({ Gop. 








ARGUMENTS EVEN 
ODD | 
These are optional keyword arguments. They specify that the next page 
of output. have an even or an odd page number. If you use EVEN, and 
depending on where you put the <PAGE>(EVEN) tag, you will have two 
consecutive pages of output numbered 10 and 12, for example. If you use 
ODD, and depending on where you put the <PAGE>(ODD) tag, you will have 
two consecutive pages of output numbered 13 and 15, for example. There 
is no blank page of output between the pages. 





related tags *  <FINAL_CLEANUP>(PAGE_BREAK) 
¢ <ONLINE_CHUNK> 





restrictions Invalid in the context of a <MATH> tag. 
The arguments EVEN and ODD are invalid in tables. 


If you use this tag in a table to force a page break, the table headings are 
not repeated on the page after the break. You must repeat the <TABLE_ 
HEADS> tag immediately after the <PAGE> tag to restore the default table 
headings. Headings are repeated on each page of a table only when 
DOCUMENT is allowed to break the table across pages. 


DESCRIPTION _ The <PaGE> tag breaks a page of text, forcing the text that follows the tag 
to begin on a new page. Using the <PAGE> tag has no effect for Bookreader 
output. 


Note: Use this tag only in special cases, where a page must be broken 
at that point. This tag is not for general use, such as for overall 
pagination; this can jeopardize the output format and device 
independence of your generically coded source file. 
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<PAGE> 





EXAMPLE The following example shows how to code a short document in which the 
information might be easier to locate when specific headings start on new 
pages. 


<HEAD1>(Survey Results) 


<PAGE> 
<HEAD2> (Brand X) 


<PAGE> 
<HEAD2> (Brand 2) 
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<PARENDCHAR> 


<PARENDCHAR> 


Supplies parentheses around a character you specify, resulting in better 
spacing of the character between the parentheses. 





FORMAT <PARENDCHAR3> (char) 





ARGUMENTS ~ char 


Specifies the character within parentheses. You specify only the character; 
the parentheses are added during processing. 





restrictions Invalid in the context of a <MATH> tag. 





DESCRIPTION _ The <PARENDCHAR> tag supplies parentheses around a character you 
specify, resulting in better spacing of the character within the parentheses. 
Frequently, writers use the name for a special character followed by that 
character in parentheses. For instance, in discussing wildcard characters, 
it is usual to say, “The percent sign (%) is the wildcard for a single 
character.” 

A problem in using proportionally spaced fonts is that single characters 
surrounded by parentheses can look crowded, like this: “The percent sign 
(%) is the wildcard for a single character.” Compare the percent sign in 
parentheses in this paragraph to the percent sign in parentheses in the 
previous paragraph; you can see the slight crowding of the percent sign in 
this paragraph. 

Typographers put a small amount of space, called a “thin space,” between 
the parentheses and the single character to achieve a balance. When you 
use the <PARENDCHAR> tag, that thin space is added for you. 


Use the <PARENDCHAR> tag to label characters that are small or that are 
more vertical than horizontal in shape. The parentheses are added during 
processing. 


ST aN RATE Ne ma NR ca es es | 
EXAMPLE The following example shows how to use the <PARENDCHAR> tag. 


<P>The tilde <PARENDCHAR>(~) is used to prevent the word 
following it from becoming a main entry in the index. 


This example produces the following output: 


The tilde (~) is used to prevent the word following it from becoming a 
main entry in the index. 


Without the <PARENDCHAR> tag, your output would look like this: 


The tilde (~) is used to prevent the word following it from becoming a main 
entry in the index. 
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<PART> 


<PART> 


Labels the start of a major division within a document and starts it on a new 
page. 





FORMAT 


<PART>/(part title[ \ symbol name])] 





ARGUMENTS 


related tags 


part title 

This is an optional argument for printed output when you process a 
single file, but required if you include the file in a bookbuild, including a 
Bookreader bookbuild. This argument specifies the title for this part of 
your document. 


symbol name 

This is an optional argument for printed output when you process a 
single file, but required if you include the file in a bookbuild, including a 
Bookreader bookbuild. This argument specifies the term that you assign 
to this part and then use to reference the part throughout your document. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





¢ <PART_PAGE> 





DESCRIPTION 
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The <PART> tag labels the start of a major division within a document and 
starts it on a new page. Parts may consist of the following: 


¢ A set of chapters or appendixes whose contents are logically related. 
The chapters or appendixes are numbered sequentially from the 
start of the document to the end, regardless of the parts; that is, the 
chapters or appendixes within each part do not begin at “1”. 


¢ A collection of units of logically related information, for example, 
reference items in the SOFTWARE doctype. 


Like chapters, parts are automatically numbered. If you specify a symbol 
name argument, a symbol table entry is created for the part. The part title 
and symbol name arguments are required for Bookreader output. 


The <PART_PAGE> tag creates a divider page for a part. You can specify a 
title for the part that is printed on the part page, a running title for the 
part (same or different from the title) that is printed on each page of the 
part, and an abstract printed on the part page to describe the information 
in the part. 


<PART> 


By default, the part page is assigned the next odd page number in the 
current numbering sequence (except for Bookreader output, where there 
are no page numbers) in a document that does not have chapters. If you 
specify the RENUMBER argument to the <ENDPART_PAGE> tag, the part 
page is assigned the number 1, and the next printed page of output is 
assigned the number 3. See the <ENDPART_PAGE> tag description for more 
information. 


Using the RENUMBER argument and the <RUNNING_TITLE> tag have no 
effect for Bookreader output. 


DOCUMENT considers each part to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 





EXAMPLE The following example shows how to use the <PART> tag. 


<part> (Introduction to Global Tags\intro_part) 

<part_page> 

<title>(<reference>(intro_part) \<reference>(intro_part\text) ) 
<abstract> 

This part contains introductory chapters. <reference>(ref_part) 
contains more detailed reference information. 

<endabstract> 

<running title>(Introduction to Global Tags) 

<endpart_page> (RENUMBER) 


This example produces the following output on the part page if this is the 
first part specified in the document: 


e The <PART PAGE> tag creates a new page of output. The page is 
assigned the next odd page number in the numbering sequence. 


¢ The title: “PART I Introduction to Global Tags” will be printed at the 
top of the part page. The first <REFERENCE> tag within the <TITLE> 
tag generates “PART I”; the second <REFERENCE> tag generates 
“Introduction to Global Tags”, as a result of using the text argument. 
You need to use the two <REFERENCE> tags to create both the part 
number and the part title. The use of uppercase Roman numerals to 
display the part number depends on the doctype you use. 


¢ The abstract text is printed. 


* The running title, “Introduction to Global Tags” is printed on each 
page of the part. 


e¢ Using the RENUMBER argument to the <ENDPART_PAGE> tag assigns 
the part page to be number 1, and the next printed page is assigned 
to be page 3. If you do not use the RENUMBER argument, the part 
page is assigned the next odd page number in the current numbering 
sequence in a document that does not have chapters. 
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<PART_PAGE> 


<PART_PAGE> 


Inserts a divider page for a new part of a document. 





FORMAT <PART_PAGE> 





ARGUMENTS — None. 





related tags ° <ABSTRACT> 
¢  <PART> 


¢ <RUNNING_TITLE> 


<TITLE> 





required <ENDPART_PAGE> 
terminator 





DESCRIPTION _ The <ParT> tag inserts a divider page for a new part of a document. You 
can use the <TITLE>, <RUNNING_TITLE>, and <ABSTRACT> tags to provide 
infomation on the part page and to specify a running title for that part of 
your document. 


The <RUNNING_TITLE> tag has no effect for Bookreader output. 


EXAMPLE See the example in the discussion of the <PART> tag. 
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<PREFACE> 


<PREFACE> 


Labels the beginning of a preface. 





FORMAT —- <PREFACE>/(page number [\ symbol name))] 





ARGUMENTS page number 
. This is an optional argument. It specifies the page number on which you 
want the preface to begin. You must specify the number with an Arabic 
numeral (the number in the formatted result will be a lowercase Roman 
numeral). If you do not specify a number, the default page on which the 
preface begins is Roman numeral five (v). This argument has no effect for 
Bookreader output. 


symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 





related tags ¢ <PREFACE_SECTION> 








restrictions Valid only in the context of a <FRONT_MATTER> tag. 
required <ENDPREFACE> 
terminator 


DESCRIPTION _ The <PREFACE> tag labels the beginning of a preface. If you want the 
preface of your document placed after the table of contents, which usually 
begins on page (Roman numeral) iii, you must specify the starting page 
number for the preface for printed output; the page number argument has 
no effect for Bookreader output. You cannot know what this number will 
be until the document is nearly completed and you know what the page 
count is for the table of contents. 


The preface always begins on a right-hand page following the table of 
contents; thus, it always begins with an odd page number, by default 

the Roman numeral five (v). You must adjust the page numbering of the 
preface, however, if the table of contents is longer than you expected (that 
is, longer than three pages). 


If the table of contents ends on an even page (therefore, a left-hand page), 
you add one to the preface’s page number, which starts the preface on the 
right-hand page. For example, if the table of contents ends on page 8, you 
would use the following tag to specify that the preface begin on page 9: 


<PREFACE> (9) 
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<PREFACE> 


If the table of contents ends on an odd page (therefore, a right-hand page), 
you add two to that page number, which starts the preface on the right- 
hand page (and in this case, leaving a blank left-hand page). For example, 
if the table of contents ends on page 9, you would use the following tag to 
specify that the preface begin on page 11: 


.<PREFACE> (11) 


You cannot reference any headings from the preface; sections you code 
within the preface with <HEADn> tags are unnumbered and do not produce 
table of contents entries. 


If your preface includes a section that you want to appear in the table of 
contents, you must code it as follows: 


<PREFACE SECTION>(New Section) 


DOCUMENT considers the preface to be an online topic. See VAX 
DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 





EXAMPLE 
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See the example in the discussion of the <FRONT_MATTER> tag. 


<PREFACE_SECTION> 


<PREFACE SECTION> 


Creates a major section in the preface of a book to provide information, such 
as a summary of changes to the book. 





FORMAT <PREFACE_SECTION> (title [| symbol name]) 





ARGUMENTS title 


Specifies the title you give to the preface section. 


symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 





related tags ¢ <PREFACE> 





restrictions Valid only in the context of a <FRONT_MATTER> tag. 


DESCRIPTION _ The <PREFACE_SECTION> tag creates a major section in the preface of a 
| book to provide information, such as a summary of changes to the book. 


Note that because <HEADn> tags in a preface do not produce table of 
contents entries, you must code sections of your preface that you want to 
appear in the table of contents as follows: 


<PREFACE SECTION> (New Section) 


EXAMPLE See the example in the discussion of the <FRONT_MATTER> tag. 
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<PRINT_DATE> 


<PRINT_DATE> 


Inserts a print date line on the copyright page. 





FORMAT <PRINT_DATE> (date) 





ARGUMENTS _— date 


Specifies official printing date information for the book. 





restrictions Valid only in the context of a <COPYRIGHT_PAGE> tag in the front matter of 
a document. 


DESCRIPTION The <PRINT_DATE> tag inserts a print date line on the copyright page. 


EXAMPL See the example in the discussion of the <FRONT_MATTER> tag. 
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<PROFILE> 


<PROFILE> 


Indicates that the source file is a profile that generates a bookbuild. 





FORMAT <PROFILE> 





ARGUMENTS ~ None. 





related tags ° <ELEMENT> 
¢ <INCLUDES_FILE> 





required <ENDPROFILE> 
terminator 





DESCRIPTION _ The <PROFILE> tag indicates that the source file is a profile that generates 
a bookbuild. A profile of a book is required in order to build (process) a 
book. Between the <PROFILE> and <ENDPROFILE> tags, you introduce each 
element of the book with an <ELEMENT> tag. 


Only those files listed with <ELEMENT> tags are included in the book 
during the bookbuild. List them in the profile in the order in which they 
appear in the book. 


Within a profile file, never include a tag that produces text. Also, do not 
place an <INCLUDE> tag in a profile. 


There are several optional tags that you can include between the 
<PROFILE> and <ENDPROFILE> tags, other than <ELEMENT> tags. These 
include the following: 


¢ <COMMENT> and <ENDCOMMENT> 

¢ <CONDITION> and <ENDCONDITION> 
¢ <CONTENTS_FILE> 

¢ <INCLUDES_FILE> 

e =6©<INDEX_FILE> 

¢ <REVISION> 

¢ <SET_CONDITION> 

¢ <SET_ONLINE_TOPIC> 


See VAX DOCUMENT Producing Online and Printed Documentation for 
more information on bookbuilding. 
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<PROFILE> 





EXAMPLE The following example shows the profile of a book that contains a table of 
contents, four chapters, an appendix, and an index. The profile shown in 


this example must be in a file by itself. You should call the file by a name 
that indicates it is a profile, such as “COMPUTER_PROFILE.SDML.” 


Each of the files named in the <ELEMENT> tags should begin with one of 
the book element tags, such as <CHAPTER>(Introduction \ introduction_ 
chap). 


<PROFILE> <COMMENT>(***Profile for How to Use a Computer***) 


<CONTENTS FILE> <COMMENT>(***insert table of contents here***) 
<ELEMENT> (Mydisk: [Mydirectory] front_matter.sdml1) 

<ELEMENT> (Mydisk: [Mydirectory]intro_chap.sdml) 

<ELEMENT> (Mydisk: [Mydirectory]applications_chap.sdml) 
<ELEMENT> (Mydisk: [Mydirectory] tools_chap.sdml) 

<ELEMENT> (Mydisk: [Mydirectory] conclusion_chap.sdml) 

<ELEMENT> (Mydisk: [Mydirectory] questions_app.sdml) 


<INDEX_FILE> <COMMENT> (***insert index here***) 
<ENDPROFILE> 
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<QUOTE> 


<QUOTE> 


Encloses text in quotation marks. The quotation marks appear as if they are 
typeset. 








FORMAT <QUOTES> (quoted text) 
or 
<QUOTE> 
quoted text 
<ENDQUOTE> 
ARGUMENTS quoted text 


related tags 


required 
terminator 


Specifies the quoted text. 





¢ <DOUBLE_QUOTE> 
e = <SINGLE_QUOTE> 





<ENDQUOTE> —Required if you do not specify the quoted text argument to 
the <QUOTE> tag. 


DESCRIPTION 


The <QUOTE> tag encloses text in quotation marks. The quotation marks 
appear as if they are typeset. 


Your terminal keyboard has two possible characters you can use for 
quotation marks: the double quote (") (ASCII 34) and the single quote 
(’ ) (ASCII 39). Neither distinguishes between opening quotation marks 
and closing quotation marks. You use the same character twice to enclose 
a word in quotation marks. 


Documents that are typeset, however, use distinct opening quotation 
marks and closing quotation marks. To obtain these distinct quotation 
marks in your output, label the text you want inside the quotation marks 
with the <QUOTE> tag. If you use the keyboard quote character instead of 
the <QUOTE> tag, the opening and closing quotation marks in your output 
will not be different from each other. 
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<QUOTE> 





EXAMPLES The following example shows how to use the <QUOTE> tag to obtain distinct 
opening and closing quotation marks in your output. 


| <P>The symbol B will be defined to be the string <QUOTE> (April 
showers.) 


This example produces the following output: 
The symbol B will be defined to be the string “April showers.” 


The following example shows the same output as the first example using 
the keyboard quotation marks instead of using the <QUOTE> tag. 


B <P>The symbol B will be defined to be the string "April 
showers." 


This example produces the following output: 
The symbol B will be defined to be the string "April showers." 


The following example shows how to code some text if you want a 
punctuation mark outside the quotation marks. Put the punctuation 
mark outside of the closing parenthesis of the argument to the <QUOTE> 
tag or after the <ENDQUOTE> tag. 


3 <P>Did Abraham Lincoln write, <QUOTE> I claim not to have controlled 
events, but confess plainly that events have controlled me <ENDQUOTE>? 


This example produces the following output: 


Did Abraham Lincoln write, “ I claim not to have controlled events, but 
confess plainly that events have controlled me ”? 
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<REFERENCE> 





<REFERENCE> 


Makes a reference to a symbol name in a book element or text element. 
When processed, the <REFERENCE> tag is replaced with the current value of 
the symbol name that is stored in the cross-reference file. 





FORMAT | \ FULL 
<REFERENCE>(symbo/l name[{ \ TEXT $]) 


| VALUE 


ARGUMENTS = symbol name 
Specifies the name of a symbol assigned in a book element or text element 
tag (for example, <HEADn> or <TABLE>). Symbol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 


FULL 


This is an optional keyword argument. It outputs all information 
associated with the symbol, including the value, type, and text. 


TEXT 

This is an optional keyword argument. It outputs only the text associated 
with the symbol table entry, that is, the caption (for figures, tables, and 
examples), or the heading text (for chapter, section, and heading-level 
tags). 


VALUE 

This is an optional keyword argument. It outputs only the current value 
of the symbol, for example, the heading level number or the table number, 
without any related text. 


If you do not specify any of the keywords, the current value of the symbol 
and the text related to the kind of symbol it is, for example, Figure 3-2 or 
Table 3-2, is output. This is the default. 





related tags ¢ <HOTSPOT>—See VAX DOCUMENT Using Doctypes and Related Tags 


DESCRIPTION _ The <REFERENCE> tag makes a reference to a symbol name in a book 
element or text element. When processed, the <REFERENCE> tag is 
replaced with the current value of the symbol name that is stored in 
the cross-reference file. 


A second argument to the tag controls the exact output of the reference. 
When you do not specify a second argument, the output defaults according 
to whether the symbol refers to a heading, a figure, a table, a chapter, and 
so on. Table 1-4 summarizes the default output for each type of text or 
book element. 
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<REFERENCE> 


Table 1-4 Element Types and Default Output of Symbol Names 


Text Element 


BOOK TITLE 
EXAMPLE — 
FIGURE 
HEADn 
TABLE 

TEXT STRING 


Book Elements 


APPENDIX 
CHAPTER 
PART 
SECTION 
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Second Argument to <REFERENCE> 


(default) VALUE © TEXT FULL 

The title argument specified in <DEFINE_BOOK_NAME>. 

“Example” number number caption “Example” number, caption 
“Figure” number number caption “Figure” number, caption 
“Section” number = number caption “Section” number, caption 
“Table” number number caption “Table” number, caption 


The text string argument specified in <DEFINE_SYMBOL>. 


(default) VALUE TEXT FULL 

“Appendix” letter letter title “Appendix” letter, title 
“Chapter” number — number title “Chapter” number, title 
“Part” number number title “Part” number, title 


“Section” number number title “Section” number, title 


See VAX DOCUMENT Producing Online and Printed Documentation for 
more information on symbol names and cross-referencing. 


For a book you create for Bookreader, you must use the <REFERENCE> tag 
to allow DOCUMENT to automatically cross-reference the symbol names 
you assign to the tag. 


The following tags require a symbol name for a book you create for 
Bookreader: 


¢ <APPENDIX> 
e <CHAPTER> 
°¢ <CHEAD> 

¢ <EXAMPLE> 


e @6<FIGURE> 
e <HEAD> 
e <HEADn> 


® <PREFACE> 

¢ <PREFACE_SECTION> 
¢ <SUBHEADn> 

° <TABLE> 

e <COMMAND> 


EXAMPLES 


<REFERENCE> 


¢ <ROUTINE> 

¢ = 6<SDML_TAG> 

¢ = <STATEMENT> 

° <SUBCOMMAND> 

The last five tags are listed in VAX DOCUMENT Using Doctypes and 
Related Tags. 


The following tags accept a symbol name, but do not require one, for both 
printed books and books you create for Bookreader: 


¢ <FRONT_MATTER> 
¢ <GLOSSARY> 

. <PART> 

¢ <MATH> 


The following tags, listed in VAX DOCUMENT Using Doctypes and Related 
Tags, accept a symbol name for a printed book; the tags are ignored for 
books you create for Bookreader: 


e <REF_NOTE> 
e <SECTION> 


When you use the <REFERENCE> tag to refer to a formal example, figure, 
or table, the words that appear in the hotspot are directly related to 
the way you code the <REFERENCE> tag. For example, suppose you enter 
a <REFERENCE>(symbol name\ VALUE) tag when referring to a hotspot, but 
you physically type in an identifying reference before the tag, like “See 
Figure <REFERENCE>(symbol name\ VALUE)”. The word that you used as the 
identifying reference will appear ouside of the hotspot; for example, “1-1” 
would appear in the hotspot, but “Figure” would not. 





The following example shows how to use the <REFERENCE> and <TABLE> 
tags to make a default reference to the symbol name of a table. The 
symbol name “lognames_tab” is defined in the <TABLE> tag and then 
referred to with the <REFERENCE> tag. 


<REFERENCE>(lognames_ tab) shows ten default system logical names. 
<TABLE> (System Logical Names\lognames_tab) 


This example produces the following output: 
Table 1-4 shows ten default system logical names.. 
For. Bookreader output, “Table 1-4” is a hotspot: [Table 1-4]. 
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The following example shows how to use the <REFERENCE> and <TABLE> 
tags to refer to the table in full, that is, to refer to the number and name 
of the table. The symbol name “lognames_tab” is defined in the <TABLE> 
tag and then referred to with the <REFERENCE> tag. 


2 <REFERENCE>(lognames_tab\full) shows ten default system logical names. 
<TABLE> (System Logical Names\lognames_tab) 


This example produces the following output: 
Table 1-4, System Logical Names, shows ten default system logical names. 


For Bookreader output, “Table 1-4, System Logical Names” is a hotspot: 


The following example shows how to use the <REFERENCE> and <HEAD1> 
tags to refer to the text of the heading. The symbol name “assigning_ 
attributes” is defined in the <HEAD1> tag and then \ referred to with the 
<REFERENCE> tag. 


3 The <REFERENCE> (assigning _attributes\text) section describes the 
method to assign color to the objects on your screen. 
<HEAD1> (Assigning Color Attributes\assigning_ attributes) 


This example produces the following output: 


The Assigning Color Attributes section describes the method to assign 
color to the objects on your screen. 


For Bookreader output, “Assigning Color Attributes” is a hotspot: 


The following example shows how to use the <REFERENCE> tag to refer to 
a chapter number without outputting any related information, such as the 
chapter title. 


4] <P>See Chapters <REFERENCE>(lognames_chap\value) and 
<REFERENCE> (filespec_chap\value) to see : 
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This example produces the following output: 
See Chapters 3 and 4 to see... 
For Bookreader output, “3” and “4” are hotspots: [3] and [4]. 


<REVISION> 


<REVISION> 


Indicates that the document contains either new or modified information. 





FORMAT 


<REVISION>/(UPDATE [\ update info])] 





ARGUMENTS 


related tags 


restrictions 


UPDATE 

This is an optional keyword argument, but you must specify it if you 
are producing the document for an update. If you specify UPDATE, the 
file must contain the <UPDATE_LRANGE> and <ENDUPDATE_RANGE> tags 

to indicate the pages to be processed. If no <UPDATE_RANGE> tags are 
present, no output is produced. The UPDATE argument has no effect for 
Bookreader output. 


update info 

This is an optional argument. It specifies information that is related to 
the system version and the date of the update. The text appears on the 
bottom of each page of output in the update. The update info argument 
has no effect for Bookreader output. 





¢ <MARK> 
¢ <UPDATE_RANGE> 





Invalid in the two multicolumn doctypes, ARTICLE and 
REPORT.TWOCOL. 





DESCRIPTION 


Note: 


The <REVISION> tag indicates that the document contains either new 

or modified information. It enables the <MARK>, <ENDMARK>, <UPDATE_ 
RANGE>, and <ENDUPDATE_RANGE> tags. By default, these tags are defined 
for all doctypes to be non-operational; that is, if a file is processed without 
the <REVISION> tag, the related tags produce no output. 


You can produce update pages only for a printed document; you cannot 
produce them for Bookreader. 


When a file that contains the <REVISION>(UPDATE) tag is processed, the 
table of contents and index are handled as follows: if you specify 
/CONTENTS and /INDEX on the command line, you receive a table of 
contents and an index even if you do not specify the <CONTENTS_FILE> and 
<INDEX_FILE> tags within the <UPDATE_RANGE> and <ENDUPDATE_RANGE> 
tags. 


If the device converter encounters errors on point pages created 
using the <REVISION>(update) tag, it signals them as occurring on the 
original page, not the point page. For example, an error on point 
page 11-2.1 is signalled as occurring on page 11-2. 
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<REVISION> 





EXAMPLES The following example shows how to use the <REVISION> tag in a document 
that is extensively revised. 
| <REVISION> 
<P> 
The following characters are legal in MACRO-11 source programs: 
<LIST> (UNNUMBERED) 
<LE>The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted to 
uppercase. 
<MARK> 
<LE>Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in <REFERENCE>(mcs_app), 
with a list of directives that support the MCS. 
<LE>The digits 0 through 9. 
<ENDMARK> 
<LE>The characters period <PARENDCHAR>(.) and dollar sign 
<PARENDCHAR>($). These characters are reserved for use as Digital 
Equipment Corporation system program symbols. 
<ENDLIST> 
This example produces the following output: 
The following characters are legal in MACRO-11 source programs: 
¢ The letters A through Z. Both upper- and lowercase letters are 
acceptable, although, upon input, lowercase letters are converted 
to uppercase. 
¢ Characters in the Digital Multinational Character Set (MCS). A chart 
showing the MCS is located in Appendix A, with a list of directives 
that support the MCS. 
e The digits 0 through 9. 
¢ The characters period (.) and dollar sign ($). These characters are 
reserved for use as Digital Equipment Corporation system program 
symbols. 
The following example shows how to use the <REVISION> tag to update a 
manual. See the <UPDATE_RANGE> tag description for more information on 
identifying a section of updated material. 


<REVISION> (UPDATE\November 1990) 


<UPDATE_RANGE> (3\10) 
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<REVISION_INFO> 


<REVISION INFO> 


Labels a section on a title page that provides information on what previous 
books have been superseded by the current one. 





FORMAT <REVISION_INFO>([title text] \ info) 





ARGUMENTS _ title text 
This is an optional argument. It specifies heading information. If you do 
not specify this argument, the default text “Revision/Update Information:” 
is supplied. 


info 
Specifies revision and update information. 





related tags ¢ <FRONT_MATTER> 





restrictions Valid only in the context of a <TITLE_PAGE> tag. 





DESCRIPTION _ The <REVISION_INFO> tag labels a section on a title page that provides 
information on what previous books have been superseded by the current 
one. 





EXAMPLE See the example in the discussion of the <FRONT_MATTER> tag. 
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<RIGHT_LINE> 


<RIGHT_LINE> 


Specifies a line of text that is to be aligned against the right-hand margin of 
the page. 





FORMAT <RIGHT_LINE> (text t | BIGSKIP ? 


| SMALLSKIP 





ARGUMENTS __ {text 


Specifies the line of text to be aligned against in the right-hand margin of 
the page. 


BIGSKIP 
SMALLSKIP 


These are optional keyword arguments. They specify that a set amount of 
vertical space precede the element identified as a line or block of text. The 
actual amount of space inserted is determined by the doctype. 








related tags * <CENTER_LINE> 
e  =6<LINE> 
restrictions Invalid in the context of an <EXAMPLE> and a <MATH> tag. 


The aligned text must fit within the right-hand margin. If you specify text 
that is too wide, the text formatter issues a warning message, and you 
should examine your output. 


DESCRIPTION _ The <RIGHT_LINE> tag specifies a line of text that is to be aligned against 
the right-hand margin of the page. This text is said to be right-justified. 


Note: When you use the <RIGHT_LINE> tag as the first tag in a table column, 
it leaves extra space in that column. 


EXAMPLES The following example shows how to use the <RIGHT_LINE>(SMALLSKIP) tag. 
<P>Please include the following information: 

<RIGHT LINE> (Name) 

<RIGHT_LINE> (Address\smallskip) 

<RIGHT_LINE> (Phone Number) 


This example produces the following output: 
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<RIGHT_LINE> 


Please include the following information: 
Name 


Address 
Phone Number 


The following example shows how to use the <RIGHT_LINE>(BIGSKIP) tag. 
<P>Please include the following information: 
<RIGHT_LINE> (Name) 


<RIGHT LINE> (Address\bigskip) 
<RIGHT_LINE> (Phone Number) 


This example produces the following output: 


Please include the following information: 


Name 


Address 
Phone Number 
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<RULE> 


<RULE> 


Outputs a horizontal rule in a table. 





<RULE> 








FORMAT 
ARGUMENTS __ None. 
e <SPAN> 


related tags 


restrictions 


<TABLE_HEADS> 


<TABLE_ROW> 


<TABLE_UNIT_HEADS> 





Valid only in an argument to a <TABLE_ROW>, <TABLE_HEADS>, or <TABLE_ 
UNIT_HEADS> tag; it must immediately follow the argument text under 
which the rule is to be placed. 





DESCRIPTION 


The <RULE> tag outputs a horizontal rule in a table. You place a <RULE> 
tag inside an argument to a <TABLE_HEADS>, <TABLE_ROW>, or <TABLE_ 
UNIT_HEADS> tag. 


The horizontal length of the rule does not correspond to the dimensions of 
the table. It equals the width of the table column or the spanned columns, 
if the argument also is preceded by a <SPAN> tag. See the <SPAN> tag 
description for more information. 


EXAMPLE 
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See the example in the discussion of the <TABLE_UNIT> tag. 


<S 


V 


Labels the system portion of a dialog between user and system in an 
interactive example. 


FORMAT <S> (text) 





ARGUMENTS __ text 


Specifies the text of the system message. 








related tags * <INTERACTIVE> 
° = =<U> 
restrictions Invalid in the context of a <MATH> tag. 





DESCRIPTION _ The <s> tag labels the system portion of a dialog between user arid system 
in an interactive example. An example containing this type of dialog must 
have both parts identified in order to differentiate the two types of text in 
the source code, the output, or both. 


In the Software doctype, you can also use the <S> and <U> tags to 
differentiate the system and user text inside of examples created with 
the <EXAMPLE_SEQUENCE> and <EXI> tags. For more information on this 
doctype, refer to VAX DOCUMENT Using Doctypes and Related Tags. 


EXAMPLES The following example shows how to use the <S> tag. 


<P>The system prompt <S>($) indicates you can enter a command. 


This example produces the following output: 
The system prompt $ indicates you can enter a command. 


The following example shows how to code dialog between both the system 
and the user. In a dialog, the <S> and <U> tags must be used between 
<INTERACTIVE> and <ENDINTERACTIVE> tags. Note that you should specify, 
within the argument to the <S> tag, whatever space follows the system 
prompt. 
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<S> 
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<P>The following example of VAXMAIL contains messages from both 
the system and a user of the system: 

<INTERACTIVE> 

<U> (mail) 

<S>(MAIL> )<U>(send) 

<S>(To: )<U>(nodename: :Courtney) 

<S> (SMAIL-E-NOSUCHUSR, no such user COURTNEY at node NODENAME) 
<ENDINTERACTIVE> 


This example produces the following output: 


The following example of VAXMAIL contains messages from both the 
system and a user of the system: 


mail 

MAIL> send 

To: nodename: :Courtney ; 

%MAIL-E-NOSUCHUSR, no such user COURTNEY at node NODENAME 


<SAMPLE_TEXT> 


<SAMPLE TEXT> 


Typographically distinguishes an extract of text. 





FORMAT <SAMPLE_TEXT> 





ARGUMENTS = None. 











related tags * <CENTER_LINE> 
* <P> 

restrictions The <SAMPLE_TEXT> tag does not provide paragraph formatting. If you 
want to show a paragraph within the sample text, you must label it with a 
<P> tag. 

required <ENDSAMPLE_TEXT> 

terminator 





DESCRIPTION The <SAMPLE_TEXT> tag typographically distinguishes an extract of text. 
The sample text is indented from the normal text margins. 





EXAMPLE The following example shows how to use the <SAMPLE_TEXT> tag. 


<P>The language is perpetually in flux: it is a living stream, 

shifting, changing, receiving new strength from a thousand tributaries. .. 
<SAMPLE_ TEXT> 

<P>Taken from Strunk, William Jr. and White, E.B.: The Elements of Style. 
Macmillan Publishing Co., Inc., 1979. 

<ENDSAMPLE_ TEXT> 


This example produces the following output: 


The language is perpetually in flux: it is a living stream, shifting, 
changing, receiving new strength from a thousand tributaries. . . 


Taken from Strunk, William Jr. and White, E.B.: The 
Elements of Style. Macmillan Publishing Co., Inc., 1979. 
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<SET_APPENDIX_LETTER> 


<SET_APPENDIX_LETTER> 


Overrides the default appendix letter assigned to an appendix by VAX 
DOCUMENT. 





FORMAT <SET_APPENDIX_LETTER> (appendix letter) 





ARGUMENTS = appendix letter 


Specifies the letter of the appendix. This argument must be a letter from 
A to Z. 





related tags ° <APPENDIX> 
¢ = =©<SET_CHAPTER_NUMBER> 


¢ The MILSPEC doctype <SET_APPENDIX_NUMBER> tag 





DESCRIPTION _ The <SET_APPENDIX_LETTER> tag overrides the default appendix letter 
assigned to an appendix by VAX DOCUMENT. The tag is useful only in 
an element build to override the default appendix letter created by VAX 
DOCUMENT; it is ignored in a bookbuild. The <SET_APPENDIX_LETTER> 
tag resets the current appendix letter and resets the lettering for all 
following appendixes. For example, if you specified C as the argument, the 
<APPENDIX> tag generates Appendix C. The next <APPENDIX> tag generates 
Appendix D, and so on. 


Place the <SET_APPENDIX_LETTER> tag in your SDML file before the 
<APPENDIX> tags you want it to affect, because the <SET_APPENDIX_LETTER> 
tag affects only the <APPENDIX> tags that follow it. 


You can use the <SET_APPENDIX_LETTER> tag multiple times in an SDML 
file. | 





EXAMPLE The following example shows how to use the <SET_APPENDIX_LETTER> 
tag. The appendix “Error Messages” is explicitly set to C using the 
<SET_APPENDIX_LETTER> tag. This causes any subsequent appendixes 
to be numbered beginning with the letter D, unless you use another 
<SET_APPENDIX_LETTER> tag to reset the current appendix letter. 


<SET_APPENDIX_LETTER> (C) 

<APPENDIX> (Error Messages\error _msg_app) 
<p> 

The following error messages... 
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<SET_CHAPTER_NUMBER> 


<SET_ CHAPTER_NUMBER> 


Overrides the default chapter number assigned to a chapter by VAX 
DOCUMENT. 





FORMAT <SET_CHAPTER_NUMBER> (chapter number) 





ARGUMENTS ~ chapter number 
Specifies the number of the chapter. This argument must be a positive 
integer. 





related tags ° <CHAPTER> 
°¢ <SET_APPENDIX_LETTER> 





DESCRIPTION _ The <SET_CHAPTER_NUMBER> tag overrides the default chapter number 
assigned to a chapter by VAX DOCUMENT. The tag is useful only in an 
element build to override the default chapter number created by VAX 
DOCUMENT; it is ignored in a bookbuild. The <SET.CHAPTER_NUMBER> 
tag resets the current chapter number and the numbering for all following 
chapters. For example, if you specify 13 as the chapter number, the 
next <CHAPTER> tag generates Chapter 13. The following <CHAPTER> tag 
generates Chapter 14, and so on. 


Place the <SET_CHAPTER_NUMBER> tag in your SDML file before the 
<CHAPTER> tags you want it to affect, because the <SET_CHAPTER_NUMBER> 
tag affects only the <CHAPTER> tags that follow it. 


You can use the <SET_CHAPTER_NUMBER> tag multiple times in an SDML 
file. 





EXAMPLE The following example shows how to use the <SET_CHAPTER_NUMBER> 
tag. The chapter is set to 13 using the <SET_CHAPTER_NUMBER> tag. This 
causes any subsequent chapters to be numbered beginning with number 
14, unless you use another <SET_CHAPTER_NUMBER> tag to reset the current 
chapter number. 


<SET_ CHAPTER _NUMBER> (13) 

<CHAPTER> (Supported Devices\sup_dev_chap) 
<p> 

The primary supported devices... 
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<SET_CONDITION> 


<SET_CONDITION> 


Creates or removes a condition in your SDML file. 





FORMAT 


<SET_CONDITION> (condition name[\ REMOVE]) 





ARGUMENTS 


related tags 


condition name 7 
Specifies a name you use to conditionalize a portion of your SDML file. 
This name is limited to 28 characters. 


REMOVE 


This is an optional keyword argument. It removes the condition name. 





¢ <CONDITION> 





DESCRIPTION 


The <SET_CONDITION> tag creates or removes a condition in your SDML 
file. You specify conditions with the <CONDITION> tag. 


For a complete explanation of creating conditional text, refer to VAX 
DOCUMENT Producing Online and Printed Documentation. 


Normally, you create a condition at the front of your input file and it 
remains in effect for the rest of the file. If you want to process a portion 
of the input file without the condition, you can remove it by repeating the 
<SET_CONDITION> tag with the REMOVE argument. 


You can use the /CONDITION qualifier on the DOCUMENT command line 
instead of placing the <SET_CONDITION> tag into your file. For example, 
you might use the command line qualifier /CONDITION=local instead of 
putting the <SET_CONDITION>(local) tag in your input file. 





EXAMPLE 
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The following example shows how to use the <SET_CONDITION> tag at the 
beginning of your file in order to establish the condition. In this case, 
the condition, set by the <SET_CONDITION>(Christmas) tag, is “Christmas”. 
This means that only the information on Christmas, designated with the 
<CONDITION> tag, is processed. 


This example also shows how to use the <SET_CONDITION> tag with the 
REMOVE argument in order to remove the condition you set with the 
<SET_CONDITION> tag. Removing the condition applies for the rest of your 
file. In this case, the first instance of Christmas information is processed, 
but all instances of Christmas information after the 
<SET_CONDITION>(Christmas\ REMOVE) tag are not processed. 


<SET_CONDITION> 


<SET_CONDITION> (Christmas) 

<CONDITION> (Christmas) 

<P>Christmas, by convention, is celebrated on December 25th... 
<ENDCONDITION> 


<CONDITION> (Chanukah) 
<P>Chanukah is called the Festival of Lights... 
<ENDCONDITION> 


<CONDITION> (Passover) 
<P>Passover is usually celebrated... 
<ENDCONDITION> 7 


<SET_CONDITION> (Christmas \REMOVE) 


<CONDITION> (Christmas \Chanukah) 

<HEAD1> (Religious Holidays) 

<P>This paragragh contains general information about several religious 
holidays... 

<ENDCONDITION> 
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<SET_FIGURE FILE SPACING _DEFAULT> 


<SET FIGURE FILE SPACING DEFAULT> 


Overrides the default for vertical blank space that appears before and after an 
included graphics file. 





FORMA <SET_FIGURE_FILE_SPACING_DEFAULT>(/space before] 
| \ [space after]) 








ARGUMENTS __ space before 
This is an optional argument. It specifies the amount of vertical space in 
picas that is to be output before the graphics file (there are 6 picas to an 
inch). This argument may be a nonnegative integer or decimal number, 
including zero. 


space after | 

This is an optional argument. It specifies the amount of vertical space in 
picas that is to be output following the graphics file (there are 6 picas to 
an inch). This argument may be a nonnegative integer or decimal number, 
including zero. 





related tags ° <FIGURE> 
¢ <FIGURE_FILE> 


DESCRIPTION The <SET_FIGURE_FILE_SPACING_DEFAULT> tag overrides the default for 
vertical blank space that appears before and after an included graphics 
file. Each doctype specifies default values for spacing that is inserted 
before and after a graphics file included using the <FIGURE_FILE> tag. 
These defaults assume that the file does not have any built-in white space. 


In some instances, graphics files may have included white space, and 
you may not be able to remove it from the graphics file itself. In these 
instances, you can use the <SET_FIGURE_FILE_SPACING_DEFAULT> tag to 
modify the amount of white space that VAX DOCUMENT places before 
and after the graphics file. 


The values specified by the <SET_FIGURE_FILE_SPACING_DEFAULT> tag 
remain in effect for all subsequent figures, or until you use the 
<SET_FIGURE_FILE_SPACING_DEFAULT> tag again. 


If you do not specify one of the arguments to the <SET_FIGURE_FILE_ 
SPACING_DEFAULT> tag, the spacing remains as though you had not used 
the tag. 


1-228 


<SET_ FIGURE FILE SPACING DEFAULT> 





EXAMPLES The following example shows how to set the figure file spacing default to 0 
picas before a figure and 1.24 picas after a figure. All subsequent graphics 
files included using the <FIGURE_FILE> tag will also have this amount of 
white space around the figure. 


<SET_FIGURE_FILE_SPACING DEFAULT>(0\1.24) 
<FIGURE> (Graphic File Inclusion) 
<FIGURE_FILE>(LNO3\MY_FILES: HOUSE. SIX\13.76) 
<ENDFIGURE> 


In the following example, the figure file spacing is set to 10 picas before the 
figure and 0 picas after it. Using the second <SET_FIGURE_FILE_SPACING_ 
DEFAULT> tag resets the amount of spacing for any subsequent figures to 2 
picas before the figure and 2 picas after the figure. 


<SET_FIGURE_FILE SPACING DEFAULT>(10\0) 
<FIGURE> (Graphic File Inclusion) 
<FIGURE_FILE> (LNO3\MY_FILES: HOUSE. SIX\13.76) 
<ENDFIGURE> 
<SET_FIGURE FILE SPACING DEFAULT>(2\2) 
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<SET_TABLE_ROW_BREAK_DEFAULT> 


<SET TABLE _ROW BREAK DEFAULT> 


Overrides the default value for a multipage table’s first valid break. 





FORMAT <SET_TABLE_ROW_BREAK_DEFAULT> (number of rows) 





ARGUMENTS number of rows 3 
Specifies the number of default table rows that must be on the first page 
of a multipage table. This argument must be a positive integer. 


You can specify the <SET_TABLE_ROW_BREAK_DEFAULT> tag anywhere in an 
SDML file. The value you specify using this tag will affect subsequent 
tables until the next occurrence of the tag or until the end of the file. 





related tags ¢ <TABLE_ROW_BREAK> 





DESCRIPTION _ The <SET_TABLE_LROW_BREAK_DEFAULT> tag overrides the default value for 
a multipage table’s first valid break. By default, tables are considered to 
be multipage; that is, if there is not enough room on the current page for a 
table, the table is continued onto subsequent pages, with any captions and 
headings repeated at the top of each new page. When the text formatter 
chooses places in the table at which to insert page breaks, it normally 
breaks the table between <TABLE_ROW> tags. By default, it assumes that it 
is correct to break a table between any two table rows after the first table 
row. 


You can override this default behavior in the following ways: 


e Specify the <SET_TABLE_ROW_BREAK_DEFAULT> tag to provide a default 
number of rows that must be on the first page of the table. For 
example, if you specify the <SET_TABLE_ROW_BREAK_DEFAULT>(8) tag, 
any subsequent table will not be broken until after the third row. 


¢ Specify the CONTROLLED argument to the <TABLE_ATTRIBUTES> tag, 
which indicates that you are going to specify, explicitly, the range 
in which the table will be allowed to break, You then must use the 
<TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags to 
indicate the first and last allowable page break points. Between these. 
two tags, the table may be broken between any two <TABLE_ROW> tags. 
See the example in the description of the <TABLE_ATTRIBUTES> tag. 


e Use the KEEP argument to the <TABLE_ATTRIBUTES> tag to indicate 
that the table must not be broken across pages, unless it is longer than 
a page. See the example in the description of the <TABLE_ATTRIBUTES> 
tag. 


¢ Use the <VALID_TABLE_ROW_BREAK> tag to indicate a place within a 
long table row that is an allowable break point. See the example in 
the description of the <VALID_BREAK> tag. 
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<SET_ TABLE ROW_BREAK_DEFAULT> 


¢ Use the <NESTED_TABLE_BREAK> tag to indicate a place in a nested 
table (a table within a table) that is an allowable break point. 


This tag has no effect for Bookreader output. 





EXAMPLE In the following example, the table consists of short, one-line items. The 
<SET_TABLE_ROW_BREAK_DEFAULT> tag indicates that this table, and any 
following it, must not be broken until after the fifth row. 


<SET_ TABLE ROW BREAK DEFAULT> (5) 
<TABLE> 

<TABLE ATTRIBUTES> (SINGLE SPACED) 
<TABLE _SETUP>(2\5) 

<TABLE _HEADS>(Code\Numeric Value) 
<TABLE_ROW> (A\1) 

<TABLE_ROW> (B\2) 


<TABLE ROW> (Z\26) 
<ENDTABLE> 
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<SINGLE_QUOTE> 


<SINGLE QUOTE> 


Supplies a single quotation mark as it appears on a keyboard. 





FORMAT <SINGLE_QUOTE> 





ARGUMENTS = None. 





related tags ¢ <DOUBLE_QUOTE> 
¢ <PARENDCHAR> 


© <QUOTE> 





DESCRIPTION _ The <SINGLE_QUOTE> tag supplies a single quotation mark as it appears on 
a keyboard. This is different from the single quotation mark that appears 
on your terminal screen. 


If you use the single quotation mark from your keyboard instead of the 
tag, your output will contain an unmatched closing single quotation 
mark—one half of what should be a matched pair according to typesetting 
conventions. 


EXAMPLE The following example shows how to use the <SINGLE_QUOTE> tag. The 
<PARENDCHAR> tag simply provides better spacing of the single quote 
within the parentheses. 


<P>Notice the difference between using the 
<tag>(single_quote) tag to output a single quotation mark, 
for example, <PARENDCHAR> (<SINGLE QUOTE>), and using the 
keyboard single quotation mark, for example, <PARENDCHAR>(’). 


This example produces the following output: 


Notice the difference between using the <SINGLE_QUOTE> tag to output a 
single quotation mark, for example, (’ ), and using the keyboard single 
quotation mark, for example, (’). 


1-232 


<SPAN> 


Specifies that the accompanying argument in a table row or a table head 
spans more than one table column. 





FORMAT 


<SPAN>(number of columns[\ LEFT]) 





ARGUMENTS 


related tags 


restrictions 


number of columns 

Specifies the number of table columns that the text following the <SPAN> 
tag spans. This argument must be a whole number and must be no larger 
than the number of table columns remaining in the table row, including 
the table column in which you placed the <SPAN> tag itself. 


LEFT 

This is an optional keyword argument. It specifies that the text of the 
argument be aligned to the left-most position of the spanned columns. If 
you do not use this argument, the text of the argument is centered in the 
spanned columns. 





e =6<RULE> 


<TABLE_HEADS> 


<TABLE_UNIT_HEADS> 





Valid only in an argument to a <TABLE_ROW>, <TABLE_HEADS>, or 
<TABLE_UNIT_HEADS> tag. 


Must immediately precede the argument text. 





DESCRIPTION 


The <SPAN> tag specifies that the accompanying argument in a table row 
or a table head spans more than one table column. The text is displayed 
without regard to the gutter that separates the columns. The text is 

centered in the spanned columns, unless you specify the LEFT argument. 


If the text length exceeds the width of the spanned columns, it is broken at 
a word boundary and displayed on additional table lines. Any additional 
lines of text are centered or aligned against the left margin to agree with 
the alignment of text in the first line. 


Use the <RULE> tag if you want to place a rule beneath a spanned heading 
created using the <SPAN> tag. 
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<SPAN> 





EXAMPLES The following example shows how to use the <SPAN> tag to center the table 


heading over three columns. It also shows how to use the LEFT keyword 
to position a table unit heading to the left-most position of the spanned 
columns. Note the use of the <RULE> tag in this example. 


<TABLE> 

<TABLE SETUP>(3\12\12) 

<TABLE HEADS>(<SPAN>(3)Types of Ancient Weaponry) 
<TABLE _UNIT> 

<TABLE UNIT HEADS>(Polearms) 

<TABLE _ROW> (Spear\Javelin\Halberd) 

<ENDTABLE UNIT> 

<TABLE_UNIT> 

<TABLE UNIT_HEADS> (Maces\<SPAN> (2\LEFT) Swords<RULE>) 
<TABLE UNIT_HEADS>( \Short swords\Long swords) 
<TABLE ROW>(Great Mace\Gladius\Great Sword) 
<ENDTABLE UNIT> 














<ENDTABLE> 
This example produces the following output: 
Types of Ancient Weaponry 
Polearms 
Spear Javelin Halberd 
Maces Swords 
Short swords Long swords 
Great Mace Gladius Great Sword 
In the following example, notice how using the <SPAN> tag in this way 
centers “Small Fixture” correctly. 
<table> 


<table _setup>(5\9\9\9\9) 

<table row>(\<span>(2)Small Fixture\<span>(2)Large Fixture) 
<table_row> (Component \Minimum\Maximum\Minimum\Maximum) 
<endtable> 


Notice, however, that “Large Fixture” may be too far to the right, as in the 
following example: 


Small Fixture Large Fixture 
Component Minimum Maximum Minimum Maximum 
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<SPAN> 


This occurs because the <SPAN> tag attempts to span the last column to the 
margin. To fix this problem, code the table to specify an additional column 
and specify a width for the next to last column, thereby limiting the 

distance that is spanned. The following is an example of such a correction: 


<table> 

<table_setup>(6\8\8\8\8\8) 

<table_row>(\<span>(2)Small Fixture\<span>(2)Large Fixture) 
<table_row> (Component \Minimum\Maximum\Minimum\Maximum) 
<endtable> 


This example produces the following output: 


Small Fixture Large Fixture 
Component Minimum Maximum Minimum Maximum 


1-235 


<SPECIAL_CHAR> 





<SPECIAL_CHAR> 


Provides access to special characters that are not available on the terminal 
keyboard. 





FORMAT <SPECIAL_CHAR>(keyword) 





ARGUMENTS keyword 
Specifies a keyword associated with the special character you want to 
produce in your output file. The character is always a non-math character. 
The following are valid keywords: 





Keyword _ Character 
CLOSE_DOUBLE_BRACKET l 
DAGGER + 
DOUBLE_DAGGER + 
DOUBLE_HYPHEN ae 
FULL_DIAMOND + 
OPEN_DOUBLE_BRACKET [ 
REGISTERED_SYMBOL ® 
SECTION_SIGN § 
TRADEMARK_SYMBOL ™ 
related tags ° <MATH_CHAR> 
e =6<MCS> 


DESCRIPTION The <SPECIAL_CHAR> tag provides access to special characters that are not 
available on the terminal keyboard. 


You can use the <SUBSCRIPT> and <SUPERSCRIPT> tags with the <SPECIAL_ 
CHAR> tag to get subscripted and superscripted characters. For example, 
you can enter the following code to get a superscripted registered symbol: 


<SUPERSCRIPT> (<SPECIAL CHAR> (REGISTERED SYMBOL) ) 
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<SPECIAL_CHAR> 





EXAM PLE In the following example, the special character ¢ is used in an example of 
terminal output to show that text wraps at the end of a line. 


SCOPY-I-COPIED, $DISK1: [MYDIRECTORY]MYFILE.PLI;5 
<tag>(special_ char) (FULL_DIAMOND) 
copied to $DISK1: [YOURDIRECTORY] YOURFILE.PLI;5 
This example produces the following output: 
SCOPY-I-COPIED, $DISK1: [MYDIRECTORY]MYFILE.PLI;5 


4 
copied to $DISK1: [YOURDIRECTORY] YOURFILE.PLI;5 
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<SUBHEADn> 


<SUBHEADn> 


Marks an unnumbered subsidiary heading. 





FORMAT <SUBHEADns> (heading text [\ symbol name}) 





ARGUMENTS heading text 
Specifies the text of the subsidiary heading. 


symbol name 

This is an optional argument. It specifies the name of the symbol 
used in all references to this heading. Symbol names must not exceed 
31 characters and must only contain alphabetic letters, numbers, or 
underscores. Do not begin a symbol name with an underscore. 





related tags ° <CHEAD> 
¢ <HEAD1> through <HEAD6> 


DESCRIPTION = The <SUBHEADI> and <SUBHEAD2> tags mark an unnumbered subsidiary 
heading. You are allowed only two levels of subheadings. Each reflects a 
logical hierarchy within the structure of the text. 


These subheadings are not numbered and do not appear in the table of 
contents. They cannot be readily used for cross-references and you should 
use them only when the clarity of your exposition requires such a fine level 
of distinction. 


In some doctypes, the distinction is made between the <SUBHEAD1> and 
<SUBHEAD2> tags by making the <SUBHEAD2> tag a run-in heading. This 
means that the following text begins on the same line as the subheading. 
The doctype controls the text formatter’s placement of the text following 
the <SUBHEAD2> tag. Whether or not you expect the heading to be run-in, 
always tag the text element following the heading (for example, always 
mark a paragraph with a <P> tag). 


EXAMPLE The following example shows how to use the <SUBHEADn> tag. 
<SUBHEAD1> (Using a Subhead\use_of_subhead) 
<P>The use of subheads should be restricted to occasions when the clarity 


of your exposition absolutely requires one. 


This example produces the following output: 


Using a Subhead 


The use of subheads should be restricted to occasions when the clarity of 
your exposition absolutely requires one. 
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<TABLE> 


<TABLE> 


Begins a sequence of columnar data. 





FORMAT 


<TABLE>/(table caption[\ symbol name))] 





ARGUMENTS 


related tags 


table caption 

This is an optional argument. It specifies the text of the caption to be 
associated with the table. Using this argument indicates that the table is 
a formal table, because the table has a number and a caption and is listed 
in the table of contents. If you do not specify a table caption argument, the 
table is considered an informal table, because it has no number or caption 
and is not listed in the table of contents. 


If the body of the table spans more than a single page of text, the table 
caption is repeated on each page on which the table continues. 


symbol name 

This is an optional argument. It specifies the symbolic identifier to be 
associated with the table. The symbol is assigned a numeric value, which 
is the current table number. The symbol and its value are placed in the 
symbol table. 


Symbol names must not exceed 31 characters and must only contain 
alphabetic letters, numbers, or underscores. Do not begin a symbol name 
with an underscore. 





¢ <ALIGN_CHAR> 

¢ <ALIGN_NUMBER> 

¢ <NESTED_TABLE_BREAK> 
¢ <REFERENCE> 

¢ <RULE> 

°e <SPAN> 

¢ = <TABLE_ATTRIBUTES> 
¢ <TABLE_FILE> 

¢ <TABLE_HEADS> 

e <TABLE_KEY> 

¢ = 6<TABLE_KEYREF> 

° <TABLE_ROW> 

¢ <TABLE_ROW_BREAK> 
¢ <TABLE_SETUP> 

¢ <TABLE_SPACE> 
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<TABLE> 


° = <TABLE_UNIT> 
e <TABLE_UNIT_HEADS> 
e =6<VALID_TABLE_ROW_BREAK> 








restrictions Invalid in the context of an <EXAMPLE>, <FOOTNOTE>, <MATH>, or <FIGURE> 
tag. 

required <ENDTABLE> 

terminator 





DESCRIPTION _ The <TABLE> tag begins a sequence of columnar data. A formal table has 
a number and a caption, can be cross-referenced, and is listed in the table 
of contents. An informal table does not have a number or a caption, 
cannot be cross-referenced, and is not listed in the table of contents. 


Note the following when processing a book for Bookreader display: 


¢ You must use the symbol name argument to process a formal table for 
Bookreader display. 


¢ DOCUMENT automatically creates pop-up windows for all formal 
tables. 


¢ When introducing and cross-referencing a formal table, you must use 
the <REFERENCE> tag to create a hotspot. Hotspots are regions in 
the windows you click on with your mouse to access cross-referenced 
topics. 


¢ You can use the <ONLINE_POPUP> tag if you want to make informal 
tables pop up. 


¢ Remember that coding a table for printed output may not be suitable 
for Bookreader output, because the Bookreader’s window is narrower 
than a printed page and the Bookreader’s font size is bigger. 


5 I Fe IE aN a ON a cE eI SSN i ae I Oa IR I ee fe 
EXAMPLES The following example shows how to produce a two-column table. 


<TABLE> (Rules for Determining Expression Modes\express_modes_tab) 
<TABLE ATTRIBUTES> (MULTIPAGE) 
<TABLE_SETUP> (2\33) 
<TABLE _HEADS>(Expression\Value Type) 
<TABLE ROW> (String value\String) 
<TABLE ROW> (Integer lexical function\Integer) 
<TABLE ROW _BREAK> (first) 
<TABLE _ROW>(Integer symbol\Integer) 
<TABLE ROW> (String symbol\String) 
<ENDTABLE> 


This example produces the following output: 
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<TABLE> 


Table n-n_ Rules for Determining Expression Modes 








Expression Value Type 
String value String 
Integer lexical function Integer 
Integer symbol Integer 
String symbol String 





The following example shows how to code a nested table. 


<TABLE> (Food Combining Workshop\schedule_tab) 
<TABLE _SETUP>(2\10) 

<TABLE HEADS>(Day\Schedule ) 

<TABLE _ROW> (Monday\<TABLE> 


<TABLE _SETUP>(2\8) 

<TABLE_ROW>(Morning\Review Workshop Objectives) 
<TABLE_ROW>(Afternoon\Study Protein Groups) 
<TABLE _ROW>(Evening\Study Minerals) 

<ENDTABLE>) 


<TABLE ROW> (Tuesday \<TABLE> 


<TABLE ROW> (Wednes 


<ENDTABLE> 


<TABLE_SETUP>(2\8) 

<TABLE _ROW>(Morning\Study Fruit Groups) 
<TABLE_ROW>(Afternoon\Study Vegetable Groups) 
<TABLE ROW>(Evening\Combining Food Groups) 
<ENDTABLE>) 


day \<TABLE> 


<TABLE _SETUP>(2\8) 

<TABLE ROW>(Morning\Poultry and Fish Diets) 
<TABLE _ROW>(Afternoon\Special Diets) 

<TABLE ROW>(Evening\Closing Remarks) 
<ENDTABLE>) 


This example produces the following output: 


Table n-n Food Combining Workshop 


Day ~ Schedule 

Monday 
Morning Review Workshop Objectives 
Afternoon Study Protein Groups 
Evening Study Minerals 

Tuesday | 
Morning Study Fruit Groups 
Afternoon Study Vegetable Groups 
Evening Combining Food Groups 

Wednesday 
Morning Poultry and Fish Diets 


Afternoon Special Diets 
Evening Closing Remarks 
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<TABLE _ATTRIBUTES> 





<TABLE _ATTRIBUTES> 


Specifies special formatting for a table. 





FORMAT <TABLE_ATTRIBUTES>(keyworda-1 
[\ keyword-2]...[\ keyword-5]) 





ARGUMENTS _ keyword-1...keyword-5 
Specifies at least one and as many as five keywords to indicate special 
formatting for the table. These keywords are listed in the following table. 





Keyword Description 
CONTROLLED Overrides the settings created by using the <SET_TABLE_ROW_BREAK_DEFAULT> tag. 


Also, indicates, for a multipage table, that the table page breaking is under explicit control of 
<TABLE_ROW_BREAKs> tags. When you use the CONTROLLED keyword, it enables the 
<TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags to indicate the 
first and last allowable page break points. Between these two tags, the table may be broken 
between any two <TABLE_ROW> tags. 

You cannot use this keyword with the KEEP keyword. 

CONTROLLED has no effect for Bookreader output. 

KEEP Indicates that the table must be kept on one page. If there is not enough room on the 
Current page, a new page is output. If the table exceeds the length of a page, the text 
formatter issues a warning message and not all the table is output. 

You cannot use this keyword with the MULTIPAGE keyword. 
KEEP has no effect for Bookreader output. 

MAXIMUM Indicates that the text of the table is adjusted to a smaller point size in order to fit within 
the left and right margins of the page. If you do not specify this argument, and if a table is 
determined during text formatting to be too wide, the text formatter will adjust the size of the 
text automatically. 


MULTIPAGE Indicates that the table is either of the following: 


¢ Longer than a page 

¢ — Allowed to break across pages 

This is the default. If you specify MULTIPAGE, you can use the <TABLE_ROW_BREAK> 
tag to control page breaks. When a formal table is continued, the table number and caption 
(with the text “Cont’d”) and column headings are automatically repeated on subsequent 
pages. When an informal table is continued, the column headings are repeated on 
subsequent pages. 

MULTIPAGE has no effect for Bookreader output; however, a long table in a pop-up window 
repeats the column headings after you scroll past each Bookreader page. 


You cannot use this keyword with the KEEP keyword. 


SINGLE_SPACED _ Specifies that the rows in the table be single-spaced; that is, there will be no more vertical 
space between lines of different table rows than there are between lines within the same 
table row. 
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<TABLE_ATTRIBUTES> 





Keyword Description 





WIDE Specifies that the width of the table exceeds the document's default width for text. 
Depending on the doctype, this argument is interpreted as follows: 


¢ — If the doctype contains a left margin area that is normally used for headings, the table’s 
width spans that area as well as the normal text area. 

* — If the document uses a multicolumn format, the table suspends multicolumn output while 
the table is processed. The table is output across two columns and then multicolumn 
output is restored. 








related tags ° <TABLE> 
¢ <TABLE_SETUP> 





restrictions 


Valid only in the context of a <TABLE> tag. 


Must precede the <TABLE_SETUP> tag. 


WIDE and MAXIMUM might not produce error-free output for 
monospaced output devices. 


DESCRIPTION _ The <TABLE_ATTRIBUTES> tag specifies special formatting for a table. 





EXAMPLES The following example uses the KEEP and WIDE attributes. 


i <TABLE> (Equivalence Names for Default Process Logical Names\equiv_names_proc_ tab) 
<TABLE _ATTRIBUTES> (WIDE\KEEP ) 
<TABLE _SETUP> (4\8\10\12) 
<TABLE HEADS> (Logical Name\Interactive\Batch\Command Procedure) 
<TABLE_ROW> (SYSS$COMMAND\Terminal\Disk\Terminal) 
<TABLE_ROW> (SYS$DISK\Disk\Disk\Disk) 
<TABLE_ROW> (SYSSINPUT\Terminal\Disk\Disk) 
<TABLE ROW>(SYSS$ERROR\Terminal\Log file\Terminal) 
<TABLE _ROW> (SYSSLOGIN\Directory\Directory\Directory) 
<TABLE_ROW> (SYSSNET\\\) . 
<TABLE_ROW> (SYSS$OUTPUT\Terminal\Log file\Terminal) 
<TABLE_ROW> (SYSSSCRATCH\Directory\Directory\Directory) 
<TABLE_ROW>(TT\Terminal\Null device\Terminal) 
<ENDTABLE> 


This example produces the following output: 
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<TABLE_ATTRIBUTES> 


Table n—-n Equivalence Names for Default Process Logical Names 





Logical Name Interactive Batch Command Procedure 
SYS$COMMAND _ Terminal Disk Terminal | 
SYS$DISK Disk Disk Disk 

SYS$INPUT Terminal Disk Disk 

SYS$ERROR Terminal Log file Terminal 

SYS$LOGIN Directory Directory Directory 

SYS$NET 

SYS$OUTPUT Terminal Log file Terminal 
SYS$SCRATCH Directory Directory Directory 

TT Terminal Null device Terminal 


The same example, but with the MAXIMUM attribute, produces the 
following output: 


Table n-n Equivalence Names for Default Process Logical Names 





Logical Name interactive Batch Command Procedure 
SYS$COMMAND Terminal Disk Terminal 

SYSSDISK Disk Disk Disk 

SYSSINPUT Terminal Disk Disk 

SYS$ERROR Terminai Log file Terminal 

SYS$LOGIN bitectary Directory Directory 

SYS$NET 

SYS$OUTPUT Terminal Log file Terminal 
SYSSSCRATCH Directory Directory Directory 

TT. Terminal Null device Terminal 


The same example, but with the SINGLE_SPACED attribute, produces the 


following output: 


Table n-n Equivalence Names for Default Process Logical Names 





Logical Name Interactive Batch Command Procedure 
SYSSCOMMAND Terminal Disk Terminal 

SYS$DISK Disk Disk Disk 

SYSSINPUT Terminal Disk Disk 

SYS$ERROR Terminal Log file Terminal 

SYS$LOGIN Directory Directory Directory 

SYS$NET 

SYSSOUTPUT Terminal Log file Terminal 
SYS$SCRATCH Directory Directory Directory 

TT . Terminal Null device Terminal 
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<TABLE_ATTRIBUTES> 


The following example shows how to code a two-column table using the 
CONTROLLED attribute to the <TABLE_ATTRIBUTES> tag, along with the 
<TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags, to override 
the settings created with the <SET_TABLE_ROW_BREAK_DEFAULT> tag. 


Suppose this table is the first of five tables in a single SDML file. You have 
set the table row break default to be 3 (using the <SET_TABLE_ROW_BREAK_ 
DEFAULT> tag). Only for this first table, moreover, you want to explicitly 
control the table page breaks (instead of the table breaks being allowed 
only after the third table row), so you allow them after the eighth and 
before the fourteenth rows using the <TABLE_ATTRIBUTES>(CONTROLLED), 
<TABLE_ROW_BREAK>(FIRST), and <TABLE_ROW_BREAK>(LAST) tags. After this 
table ends, the <SET_TABLE_ROW_BREAK_DEFAULT>(3) tag takes effect again 
for the next four tables. 


<SET_TABLE ROW_BREAK DEFAULT> (3) 


<TABLE> (Rules for Determining Expression Modes\express | mages _ tab) 
<TABLE | ATTRIBUTES> (MULTIPAGE\CONTROLLED) 

<TABLE - SETUP> (2\43) 

<TABLE . HEADS> (Expression\Value Type) 

<TABLE _ROW>(Integer value\Integer) 

<TABLE ROW> (String value\String) 

<TABLE _ROW> (Integer lexical function\Integer) 

<TABLE ROW>(String lexical function\String) 

<TABLE _ROW> (Integer. symbol\Integer) 

<TABLE _ROW>(String symbol\String) 

<TABLE ROW> (Any value .AND. or .OR. any value\Integer) 
<TABLE _ROW>(Any value\Integer) 


<COMMENT> (Break after this) 


<TABLE ROW | BREAK> (first) 

<TABLE - ROW> (Any value\Integer) 

<TABLE _ROW>(Integer value\Integer)' 
<TABLE _ROW> (String value\String) 
<TABLE ROW> (Integer lexical function\Integer) 
<TABLE _ROW>(String lexical function\String) 


<COMMENT> (Do not break after ei 


<TABLE ROW _BREAK> (last) 


<TABLE _ROW> (Integer symbol\Integer) 

<TABLE _ROW> (String symbol\String) 

<TABLE ROW>(Any value .AND. or .OR. any value\Integer) 
<TABLE_ROW> (Any value\Integer) 

<TABLE_ROW> (Any value\Integer) 


<ENDTABLE> 
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<TABLE FILE> 


<TABLE FILE> 


Causes a separate file containing a formal table to be included in the SDML 
input file. 





FORMAT <TABLE FILE>/{ fle spec —\) 
7 logical name 





ARGUMENTS _ file spec 
Specifies the file specification of the file to be included. 


logical name 

Specifies the logical name of the file to be included. You can define a 
logical name in your profile using an <INCLUDES_FILE> tag. If you do not 
define the logical name in the profile with the <INCLUDES_FILE> tag, be 
sure you define the logical name elsewhere before processing the file with 








VAX DOCUMENT. 
related tags °  <TABLE> 
restrictions Valid only in the context of a <TABLE> tag. 


DESCRIPTION _ The <TABLE_FILE> tag causes a separate file containing a formal table to be 
included in the SDML input file. (It is identical in action to the <INCLUDE> 
tag.) The included file should be an SDML file containing a completely 
coded table. 


By keeping a table in a separate SDML file, you can include the table in 
more than one document, or in chapters of the same document, without 
having to reproduce the code. In each location, the table is given a 
different number. 


EXAMPLES The following example shows how to use the <TABLE_FILE> tag to include 
a wide table that is contained in a separate file, called STANDARD_ 
FILETYPES.SDML. 


Note that the included table file will not process individually. It will 
only process when you include it in another SDML file that specifies the 
<TABLE> and <ENDTABLE> tags. 
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<TABLE_FILE> 


<TABLE> (Default VMS File Types\stand_filetypes_ tab) 
<TABLE _ATTRIBUTES> (wide) 

<TABLE FILE>(standard_filetypes.sdml) 

<ENDTABLE> 


In the following example, the file ENDLIST.SDML contains all the tags 
required for the table. 


<REFERENCE> (command_sum_tab) lists all the commands. 
<TABLE_FILE>(endlist.sdml) 


The tags in ENDLIST.SDML are: 


<TABLE> (Command Summary \command_sum_tab) 
<TABLE_ATTRIBUTES> (Multipage) 
<TABLE_SETUP> (2\18) 

<TABLE HEADS>(Command\Description) 
<TABLE ROW>(... ) 


<ENDTABLE> 


This example assumes that the table is being used in only one document. 
Placing the table in a separate file allows you to process it individually, or 
in the context of the file in which it occurs. 
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<TABLE_HEADS> 





<TABLE _HEADS> 


Specifies column headings for each column in the table. 





FORMAT <TABLE_HEADSs> (col heading-1 
[\ col heading-2...[\ col heading-9]]) 





ARGUMENTS _ col heading 


Specifies the heading for each column; the first argument is the heading 
for the first column. You can specify up to nine column headings. 








related tags ° <RULE> 
e <SPAN> 
e @6©<<TABLE> 
restrictions 


¢ Valid only in the context of a <TABLE> tag. 
¢ Invalid in the context of a <TABLE_UNIT> tag. 





DESCRIPTION _ The <TABLE_HEADS> tag specifies column headings for each column in the 
table. It is not required in a table tags sequence, however. 


A heading can be any length, and is automatically formatted correctly on 
one or more lines. 


Within tables, you can use the <TABLE_HEADS> tag to specify multipage 
headings for a table. You can also use it to place new headings in the 
middle of a table. You cannot use the tag, however, in a table unit. 





EXAMPLE The following example shows how to use the <TABLE_HEADS> tag to produce 
a two-column table. Notice that you can use the <TABLE_HEADS> tag both 
at the top of the table to establish the headings, and also in the middle of 
the table to change the headings. 


<TABLE> (Rules for Determining Expression Modes\express modes tab) 
<TABLE _ATTRIBUTES> (WIDE\MULTIPAGE) > - 
<TABLE SETUP> (2\33) 

<TABLE HEADS>(Expression\Value Type) 

<TABLE _ROW>(Integer value\Integer) 

<TABLE_ROW> (String value\String) 

<TABLE HEADS>(Value Type\Expression) 

<TABLE ROW>(Integer\Integer lexical function) 
<TABLE_ROW>(String\String lexical function) 

<TABLE ROW>(Integer\Integer symbol) 

<TABLE ROW>(String\String symbol) 

<ENDTABLE> 
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<TABLE _HEADS> 


This example produces the following output: 


Table n—n Rules for Determining Expression Modes 


Expression Value Type 

Integer value Integer 

String value String 

Value Type Expression 

Integer Integer lexical function | 
String String lexical function 
Integer Integer symbol 

String String symbol 
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<TABLE_KEY> 


<TABLE _KEY> 


Begins a key or legend for a table. 





FORMAT 


<TABLE_KEY> 





ARGUMENTS 


related tags 


restrictions 


required 
terminator 


None. 





¢ <FOOTNOTE> 

e =6©.<TABLE> 

e¢ =6<TABLE_KEYREF> 
¢ <TABLE_SETUP> 





Valid only in the context of a <TABLE> tag. 


Must appear immediately after the <TABLE_SETUP> tag, either before or 
after any <FOOTNOTE> tags. 


When you use a <TABLE_KEY> tag, the number of possible footnotes for the 
same table is reduced from 12 to 11. 


The tags that you can use between the <TABLE_KEY> and <ENDTABLE_KEY> 
tags are restricted to the <P>, <LIST>, and <EMPHASIS> tags. For example, 
you cannot use a <TABLE_ROW> tag within the table key. 


Invalid in a nested table (a table within a table). The <TABLE_KEY> tag 
must follow the <TABLE_SETUP> tag for the outermost table. 





<ENDTABLE_KEY> 


DESCRIPTION 
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The <TABLE_KEY> tag begins a key or legend for a table. Abbreviations or 
special terms are often used in a table, either in the column headings or in 
the entries of the table. The table may then need a key or legend printed 
below it to explain the special terms. The <TABLE_KEY> tag begins such a 
table key. 


A table key differs from a table footnote in that the table key is not 
numbered and does not refer to a callout in the table. You can declare 
only one table key for a table, whereas up to 12 footnotes are possible for 
a table that does not include a table key, or up to 11 footnotes for a table 
that does include a table key. 


<TABLE _KEY> 


Declare the table key immediately after the <TABLE_SETUP> tag that 
begins the table and before the first tag that begins the table rows. 

This placement is identical to the placement for footnotes in a table. If 
footnotes are also present, they either can precede or follow the table key 
declaration. 


Use the <TABLE_KEYREF> tag to specify where you want the table key to 
be output. When the table is a multipage table and if you want the table 
key printed at the foot of any or all portions of the table, place the <TABLE_ 
KEYREF> tag anywhere in the argument list to the <TABLE_HEADS> tag. For 
a book you create for Bookreader, the table key will always appear at the 
end of the table. 


If you want the table key to be printed only on specified pages of a 
multipage table, place the <TABLE_KEYREF> tag in any <TABLE_ROW> tag 
that corresponds to the different pages. You may have to print your table 
before you can determine which <TABLE_ROW> tags correspond to which 


pages. 


a a a a a a a Ne I OD PT ee 
EXAMPLE The following example shows how to use the <TABLE_KEY> tag. 


<table>(Compatability of Lock Modes\lock_tab) 
<table_attributes>(wide\keep) 
<table_setup>(7\10\5\5\5\5\5) 


<table key> 
<emphasis>(Key to Lock Modes\bold) 
<list> (simple) 
<le>NL---Null lock 
<le>CR---Concurrent read 
<le>CW---Concurrent write 
<le>PR---Protected read 
<le>PW---Protected write 
<le>EX---Exclusive lock 
<ENDLIST> 
<endtable_ key> 


<table_heads>(Mode of Requested\ 
<span>(5)Mode of Currently Granted Locks<rule>) 

<table heads>(Lock<TABLE_KEYREF>\NL\CR\CW\PR\PW\EX) 
<table_row>(NL\Yes\Yes\Yes\Yes\Yes\Yes) 
<table _row>(CR\Yes\Yes\Yes\Yes\Yes\No) 
<table_row>(CW\Yes\Yes\Yes\No\No\No) 
<table_row>(PR\Yes\Yes\No\Yes\No\No) 
<table_row>(PW\Yes\Yes\No\No\No\No) 
<table_row>(EX\Yes\No\No\No\No\No) 


<endtable> 


This example produces the following output: 
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<TABLE_KEY> 


Table n-n Compatibility of Lock Modes 





Mode of 
Requested 
Lock 

NL 

CR 

Cw 

PR 

PW 

EX 


NL 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 


Key to Lock Modes 


NL—Null lock 


CR—Concurrent read 


Mode of Currently Granted Locks 


CR 
Yes 
Yes 
Yes 
Yes 
Yes 
No 


CW—Concurrent write 


PR—Protected read 
PW—Protected write 
EX—Exclusive lock 
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CW 


Yes 
Yes 
Yes 
No 
No 
No 


PR 


Yes 
Yes 
No 
Yes 
No 
No 


PW 
Yes 
Yes 
No 
No 
No 
No 


EX 


Yes 
No 
No 
No 
No 
No 


<TABLE_KEYREF> 


<TABLE_KEYREF> 
Specifies that a table key be printed below the table (or any portion of a 
multipage table) in which this tag appears. 


FORMAT <TABLE_KEYREF> 








ARGUMENTS _ None. 








related tags °. <TABLE_KEY> 
restrictions Valid only in the context of a table in which you specify the <TABLE_KEY> 
tag. 


Invalid in nested tables (a table within a table). 


You can use this tag only at the end of an argument list and you cannot 
embed it in text. The end of an argument list is indicated by a backslash 
(\) or a closing parenthesis ()). 


DESCRIPTION _ The <TABLE_KEYREF> tag specifies that a table key be printed below the 
table (or any portion of a multipage table) in which this tag appears. The 
table key is printed only if the <TABLE_KEYREF> tag appears in the table. 


If you want the table key printed at the foot of all portions of a multipage 
table, place the <TABLE.KEYREF> tag anywhere in the argument list to the 
<TABLE_HEADS> tag. 


If you want the table key to be printed only on specified pages of a 
multipage table, place the <TABLE_LKEYREF> tag anywhere in the argument 
list to the <TABLE_ROW> tag that corresponds to the different pages. You 
may have to print your table before you can determine which <TABLE_ROW> 
tags correspond to which pages. 


EXAMPLE See the example in the discussion of the <TABLE_KEY> tag. 
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<TABLE ROW> 





<TABLE ROW> 


Specifies text for each column in a table. 





FORMAT <TABLE_ROW>(column text-1 
[\ column text-2...[\ column text-9]]) 





ARGUMENTS ~ column text 
Specifies text for a single column in the table row. The number of 
arguments depends on the number of columns you specify for the table 
using the <TABLE_SETUP> tag; you can specify up to 9 columns. If the 
number of arguments to the <TABLE_ROW> tag exceeds the number of 
columns currently in effect for the table, the excess columns are ignored. 
If the number of arguments is less than the number of columns currently 
in effect for the table, unspecified columns are output as blanks. 





related tags ¢ <ALIGN_CHAR> 
| ¢ <ALIGN_NUMBER> 
¢ <RULE> 
° <SPAN> — 
° <TABLE> 


¢ <TABLE_ROW_BREAK> 
¢ =©<VALID_TABLE_ROW_BREAK> 





restrictions Valid only in the context of a <TABLE> tag. 


If the text in a single table row column exceeds the length of an 
output page, the text formatter issues an error message and terminates 
processing. 


You can control page breaking of long table rows, with additional 
restrictions, using the <VALID_ROW_BREAK> tag. 


DESCRIPTION _ The <TABLE_ROW> tag specifies text for each column in a table. 


EXAMPLE The following example shows how to use the <TABLE_ROW> tag to produce 
a two-column table. 
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<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 


<TABLE ATTRIBUTES> (WIDE \MULTIPAGE) 
<TABLE _SETUP>(2\43) 
<TABLE _HEADS>(Expression\Value Type) 
<TABLE_ROW> (Integer value\Integer) 
<TABLE _ROW> (String value\String) 
<TABLE_ROW> (Integer lexical function\Integer) 
<TABLE ROW>(String lexical function\String) 
<TABLE ROW>(Integer symbol\Integer) 
<TABLE _ROW>(String symbol\String) 
<TABLE _ROW>(Any value .AND. or .OR. any value\Integer) 
<TABLE _ROW> (Any value\Integer) 
<TABLE ROW> (Any value\Integer) 

<ENDTABLE> 


This example produces the following output: 


Table n—n_ Rules for Determining Expression Modes 


<TABLE_ROW> 








Expression Value Type 
Integer value Integer 
String value String 
Integer lexical function Integer 
String lexical function String 
Integer symbol integer 
String symbol String 

Any value .AND. or .OR. any value Integer 
Any value Integer 

Any value Integer 
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<TABLE _ROW_BREAK> 


<TABLE ROW BREAK> 


Specifies the boundaries in which a long table can be broken onto a new 
page. 








FORMAT ae} 
BREAK 
<TABLE_ROW_ >(| ) 
ARGUMENTS _ FIRST 
LAST 


related tags 


restrictions 


If you use <TABLE_ATTRIBUTES>(CONTROLLED), these keyword arguments 
specify the bounds within which a multipage table may be broken. After 
you specify the <TABLE_ROW_BREAK>(FIRST) tag, any row in the table up to 
the occurrence of the <TABLE_LROW_BREAK>(LAST) tag is treated as a suitable 
page-breaking point. 





¢ <NESTED_TABLE_BREAK> 

e =6©<TABLE> 

¢ <TABLE_ATTRIBUTES>(CONTROLLED) 
¢ <TABLE_UNIT> 

¢ <VALID_TABLE_ROW_BREAK> 





Ignored in a table specified with the <TABLE_ATTRIBUTES>(KEEP) tag and in 
a nested table. 


Enabled only by the <TABLE_ATTRIBUTES>(CONTROLLED) tag. 


DESCRIPTION 
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The <TABLE_ROW_BREAK> tag specifies the boundaries in which a long 
table can be broken onto a new page. You must, however, use the <TABLE_ 
ATTRIBUTES>(CONTROLLED) tag in order for the <TABLE_LROW_BREAK> tag to 
work. The <TABLE_ROW_BREAK> tag has no effect for Bookreader output. 


Tables in VAX DOCUMENT are, by default, multipage tables. If you 

do not specify <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) 
to provide the text formatter with reasonable guidelines to break tables 
across pages, the text formatter will nonetheless select page breaks. The 
page breaks selected will not always be suitable. Therefore, using the 
<TABLE_ROW_BREAK> tag is recommended. 


If the table includes long table units and you want to allow them 

to break across pages, use the <TABLE_ROW_BREAK>(FIRST) and 
<TABLE_ROW_BREAK>(LAST) tags within the bounds of each <TABLE_UNIT> 
and <ENDTABLE_UNIT> tag. 


<TABLE_ROW_BREAK> 


By default, the text formatter will not break a page within a table row. 
With some restrictions, you can specify valid page breaks within table 
rows using the <VALID_TABLE_ROW_BREAK> tag. See the <VALID_TABLE_ROW_ 
BREAK> tag description for more information. 


You can give, with some restrictions, a nested table (that is, a table within 
a table) valid page breaks using the <NESTED_TABLE_BREAK> tag. See the 
<NESTED_TABLE_BREAK> tag description for more information. 





EXAMPLE The following example shows how to produce a two-column table using the 
<TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) tags. Note that 
you must use the CONTROLLED argument to the <TABLE_ATTRIBUTES> 
tag to enable the <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) 
tags. 


<TABLE>(Rules for Determining Expression Modes\express_modes_tab) 
<TABLE _ATTRIBUTES> (WIDE\MULTIPAGE\CONTROLLED) 
<TABLE SETUP>(2\43) 
<TABLE_HEADS> (Expression\Value Type) 
<TABLE _ROW> (Integer value\Integer) 
<TABLE _ROW> (String value\String) 
<TABLE ROW> (Integer lexical function\Integer) 


<COMMENT> (break after this) 
<TABLE_ROW_BREAK> (first) 
<TABLE ROW>(String lexical function\String) 
<TABLE ROW> (Integer symbol\Integer) 
<COMMENT>(do not break after this) 
<TABLE_ROW_BREAK> (last) 


<TABLE _ROW> (String symbol\String) 

<TABLE ROW>(Any value .AND. or .OR. any value\Integer) 
<TABLE ROW> (Any value\Integer) 

<TABLE_ROW> (Any value\Integer) 

<TABLE_ROW> (Integer value\Integer) 

<TABLE _ROW> (String value\String) 

<TABLE _ROW> (Integer lexical function\Integer) 

<TABLE _ROW>(String lexical function\String) 
<TABLE ROW> (Integer symbol\Integer) 

<TABLE ROW>(String symbol\String) 

<TABLE _ROW> (Any value .AND. or .OR. any value\Integer) 
<TABLE _ROW> (Any value\Integer) 

<TABLE _ROW> (Any value\Integer) 


<ENDTABLE> 


This example produces the following output (except for Bookreader output, 
where the <TABLE_ROW_BREAK> tag has no effect): 


Table n—n Rules for Determining Expression Modes 








Expression Value Type 
Integer value Integer 
String value String 
Integer lexical function Integer 
String lexical function String 
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<TABLE_ROW_BREAK> 


Table n—n (Cont.) Rules for Determining Expression Modes 








Expression Value Type 
Integer symbol Integer 
String symbol String 
Any value .AND. or .OR. any value Integer 
Any value . Integer 
Any value Integer 
Integer value Integer 
String value String 
Integer lexical function Integer 
String lexical function Siring 
Integer symbol Integer 
String symbol String 
Any value .AND. or .OR. any value integer 
Any value Integer 
Any value Integer 
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<TABLE_SETUP> 


<TABLE SETUP> 


Declares up to 9 columns in a table and the approximate width to be assigned 
to each column. 





FORMAT 


<TABLE_SETUP>(number | width,[ ... \ width, mber—1) 





ARGUMENTS 


related tags 


restrictions 


number 
Specifies the number of columns in the table. Must be a numeric argument 
in the range of 2 through 9. 


width, 


Widthyumber—1 

Specify the approximate widths of columns 1 through number — 1. Do not 
specify the width of the last column. This column occupies the space left 
between the second-to-last column and the right margin. 


The width unit is measured in characters. This is an approximate 
measurement, however, because the width of each character depends 

on the fonts being used in the doctype. You may need to modify the width 
argument after processing the table and viewing the output. 





e 6<TABLE> 


¢ <TABLE_ATTRIBUTES> 





° Valid only in the context of a <TABLE> tag. 


e¢ Ifyou do not include the <TABLE_SETUP> tag in a sequence of <TABLE> 
tags, no table is included in your output. 


¢ Must appear after the <TABLE_ATTRIBUTES> tag and before the <TABLE_ 
ROW> tags in the table tag sequence. 


Sa a a a EL a NT aE I I I ee 


DESCRIPTION 


The <TABLE_SETUP> tag Declares up to 9 columns in a table and the 
approximate width to be assigned to each column. 


In the width argument, define the width of each column except the last, 
which is supplied automatically. 


Values you specify in the <TABLE_SETUP> tag are checked during processing 
to determine whether the values exceed or approach the table’s limit for 
the given doctype. Warning or error messages are issued as appropriate. 


If the table column widths do not allow the table to fit within the page 

width, the text processor substitutes a smaller point size for the font in 
which the table is set. It then attempts again to fit the table within the 
text margin. 
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<TABLE _SETUP> 





EXAMPLE The following example shows how to use the <TABLE_SETUP> tag. 


<TABLE>(Names of Cheeses from Around the World\cheeses_tab) 
<TABLE_ATTRIBUTES> (wide\multipage) 

<TABLE_SETUP> (4\14\14\14) 

<TABLE_HEADS> (Cheese Name\Location of Production\Type\Color) 
<TABLE_ROW>(Spreadable\Great Britain\Curdled\White) 

<TABLE _ROW>(Smooth\Switzerland\Aged and Tasty\Off yellow) 
<TABLE_ROW> (Chunky \American\Bland\Yellow) 

<ENDTABLE> 


This example produces the following output: 


Table n—n Names of Cheeses from Around the World 








| Location of | 
Cheese Name Production Type Color 
Spreadable Great Britain Curdled White 
Smooth Switzerland Aged and Tasty Off yellow 
Chunky American Bland Yellow 
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<TABLE SPACE> 


<TABLE _SPACE> 


Marks a blank space in a table where information will be pasted in during final 
production. 


FORMAT <TABLE_SPACE>(value | text) 





ARGUMENTS _ value 7 | 


Specifies the amount of vertical space (in picas) you want left on the page. 


text | 

Specifies text that describes the. status of the table (for example, “To Be 
Set,” an art file number, or some other note). The text is output in the 
middle of the space left for the table. 





restrictions You must use this tag as an argument to a <TABLE_ROW> tag. 


DESCRIPTION _ The <TABLE_SPACE> tag marks a blank space in a table where information 
will be pasted in during final production. Specify the value argument in 
picas. There are 6 picas in an inch (and 12 points in a pica). Thus, if the 
table you want pasted in is four inches high, you should specify 24 picas. 
If you do not specify a value, a default value of 8 picas is used. 





If you specify some descriptive text in the second argument, that text is 
output in the middle of the space left for the table. 


EXAMPLE The following example shows how to code a table with the <TABLE_SPACE> 
tag. Each <TABLE_SPACE> tag reserves space inside of the table row for a 
diagram. 

<TABLE> (Script Control Blocks\script_tab) 

<TABLE ATTRIBUTES> (WIDE) 
<TABLE _SETUP>(2\22) 


<TABLE HEADS> (Block ID\Layout) 
<TABLE _ROW>(SCBEG; starts the scripting sequence\<TABLE SPACE>(4\SCBEG diagram) ) 


<TABLE_ROW>(SCMID; gives the body of the script \<TABLE_SPACE> (4\SCMIDdiagram) ) 


<TABLE ROW>(SCEND; ends the scripting sequence\<TABLE SPACE>(4\SCEND diagram) ) 
<ENDTABLE> . 


This example produces the following output: 
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<TABLE_SPACE> 


Table n—n_ Script Control Blocks 
Block ID Layout 


SCBEG; starts the scripting 
sequence 


SCBEG diagram 


SCMID; gives the body of the 
script 


SCMID diagram 


SCEND; ends the scripting 
sequence 


SCEND diagram 
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<TABLE_UNIT> 





<TABLE _UNIT> 


Begins a portion of a table containing rows that you want to group as a logical 
unit. 





FORMAT <TABLE_UNIT> 





ARGUMENTS ~ None. 





related tags ° <TABLE> 
¢ <TABLE_ROW_BREAK> 


e =©6<TABLE_UNIT_HEADS> 





restrictions Valid only in the context of a <TABLE> tag. 


You must not declare the <TABLE_ATTRIBUTE> tag with the KEEP argument 
in the context of the <TABLE_UNIT> tag. 





required <ENDTABLE_UNIT> 
terminator | 





DESCRIPTION _ The <TABLE_UNIT> tag begins a portion of a table containing rows that you 
want to group as a logical unit. You can give the table unit a heading. 


If the table units are long and you want to allow them to break across 
pages, use the <TABLE_ROW_BREAK>(FIRST) and <TABLE_ROW_BREAK>(LAST) 
tags within the bounds of each <TABLE_UNIT> and <ENDTABLE_UNIT> tag. 





EXAMPLE The following example shows how to use the <TABLE_UNIT> tag. 


<Table>(String Passing Techniques Used by the Run-Time Library\Str_Tech_Tab) 
<TABLE_ATTRIBUTES> (WIDE\MULTIPAGE) 

<Table Setup>(4\20\7\10) 

<Table_ Heads>(\<SPAN>(3)String Descriptor Fields<RULE>) 

<Table Heads>(String Type\Class\Length\Pointer) 


<Table Unit> 

<Table Unit_Heads>(<SPAN>(4\LEFT) Input Argument to Procedures) 
<Table Row>(Input string passed by descriptor\Read\Read\Read) 
<Endtable Unit> 
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_<TABLE_UNIT> 


<Table_ Unit> 

<Table Unit _Heads>(<SPAN>(4\LEFT) Output Argument from Procedures; 

Called Procedure Assumes the Descriptor Class) 

<Table_ Row> (Output string passed by descriptor, 
fixed-length\Ignored\Read\Read) 

<Table Row>(Output string passed by descriptor, dynamic\Ignored\Read, may be 
modified\Read, may be modified) 

<Endtable Unit> 


<Table_Unit> 

<Table Unit Heads>(<SPAN>(4)Output Argument from Procedures, Calling Program 
Specifies the Descriptor Class in the Descriptor) 

<Table_Row>(Output string, fixed-length ---DSCSK_CLASS = S, Z, A, NCA, SD 
\Read\Read\Read) 

<Table_ Row>(Output string, dynamic ---DSCSK_CLASS D 

\Read\Read, may be modified\Read, may be modified) 

<Table Row>(Output string, varying-length ---DSC$K_CLASS_VS 

\Read\MAXSTRLEN is read; CURLEN is modified\Read) 

<Endtable Unit> 


<Endtable> 


This example produces the following output: 


Table n—n_ String Passing Techniques Used by the Run-Time Library 





String Descriptor Fields 





String Type Class Length Pointer 
Input Argument to Procedures 

Input string passed by Read Read Read 
descriptor 


Output Argument from Procedures; Called Procedure Assumes the Descriptor Class 


Output string passed by Ignored Read Read 

descriptor, fixed-length 

Output string passed by Ignored Read, may be Read, may be modified 
descriptor, dynamic modified 





Output Argument from Procedures, Calling Program Specifies the Descriptor Class in the Descriptor 


Output string, fixed-length Read Read Read 
—DSC$K_CLASS = S, Z, A, 
NCA, SD 
Output string, dynamic Read Read, may be Read, may be modified 
—DSC$K_CLASS_D modified 
Output string, varying-length Read MAXSTRLEN Read 
—DSC$K_CLASS_VS is read; 

CURLEN is 

modified 
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<TABLE_UNIT_HEADS> 


<TABLE _UNIT_HEADS> 


Specifies headings you want to use for a table unit. 








FORMAT <TABLE_UNIT_HEADS=>(col heading-1 
[\ col heading-2...[\ col 
heading-9]]) 
ARGUMENTS _ col heading 


related tags 


restrictions 


Specifies the text for the heading for each column. The first argument is 
the heading for the first column. You can specify up to nine arguments, 
depending on the number of columns in the table. 





e =6©<RULE> 
e =6<SPAN> 
e =©6<TABLE_UNIT> 





Valid only in the context of a <TABLE_UNIT> tag. 
Must immediately follow the <TABLE_UNIT> tag. 


DESCRIPTION 


The <TABLE_UNIT_HEADS> tag specifies headings you want to use for a table 
unit. The number of column headings depends on the number of columns 
in the table, as determined by the <TABLE_SETUP> tag. 


Often, the heading for a table unit is used to supply a single heading that 
spans the columns of the table and serves to label the table unit, rather 
than the individual columns. In this case, supply an argument that begins 
with the <SPAN> tag. 


A null argument leaves the corresponding table column blank. 


You can supply more than one <TABLE_UNIT_HEADS> tag following a 
<TABLE_UNIT> tag. 
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<TABLE_UNIT_HEADS> 


When the heading text for a table column requires multiple lines, you can 
do the following: 


¢ Supply the text as a long argument to a single <TABLE_UNIT_HEADS> 
tag. The text is automatically displayed on the required number of 
lines. 


¢ Supply the text of the heading as shorter arguments to successive 
<TABLE_UNIT_HEADS> tags. In this way, you can control how the text is 
displayed on successive lines of the heading. 


If a page break occurs in the table unit, all lines of the table unit heading 
are repeated at the top of the next page. 





EXAMPLE 
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See the example in the discussion of the <TABLE_UNIT> tag. 


<TAG> 





<TAG> 


Labels a tag and its arguments. 





FORMAT <TAG>(tag name [\tag arg-1.. . [\ tag arg-8])) 





ARGUMENTS _ tag name 


Specifies the name of the tag. 


tag arg 

This is an optional argument. It specifies an argument to the tag. The 
number of arguments you specify depends on the number of arguments 
available to the tag you are labeling. 





related tags ° <LITERAL> 





restrictions Invalid in the context of a <MATH> tag. 





DESCRIPTION _ The <TAG> tag labels a tag and its arguments. 





EXAMPLES The following example shows how to use the <TAG> tag. 
<P>You use the <TAG>(p) tag to begin a new paragraph. 

This example produces the following output: 

You use the <P> tag to begin a new paragraph. 


The following example shows how to use the <TAG> tag with an argument. 


2 Use the <TAG> (code_example\WIDE) tag if your example 
has long lines. 
This example produces the following output: 
Use the <CODE_EXAMPLE>(WIDE) tag if your example has long lines. 
The following example shows the difference in output caused by the <TAG> 
tag and the <LITERAL> tag. 
3; A writer can use the <tag>(line_art) tag to label a rough sketch. A writer 


should not use the <literal><icon><endliteral> tag for that purpose. 


This example produces the following output: 


A writer can use the <LINE_ART> tag to label a rough sketch. A writer 
should not use the <icon> tag for that purpose. 
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<TITLE> 


<TITLE> 


Labels the title used on either a title page or part page. (A part page is a 
divider page for a new part of a document.) 





FORMAT 


<TITLE> (title line-1[\ title line-2[\ title line-3]]) 





ARGUMENTS 


related tags 


restrictions 


title line-n 


Specifies one to three separate lines of text for the title. 





e =<PART_PAGE> 
e = 6<TITLE_PAGE> 





Valid only in the context of a <PART_PAGE> or a <TITLE_PAGE> tag. 
Must appear immediately after the <PART_PAGE> or <TITLE_PAGE> tag. 


The <RIGHT_LINE> and <CENTER_LINE> tags are invalid within an argument 
to the <TITLE> tag. 


Accepts only two title line arguments when used within a part page or in 
the SOFTWARE.BROCHURE doctype. 


DESCRIPTION 


The <TITLE> tag labels the title used on either a title page or part page. (A 
part page is a divider page for a new part of a document.) 


On a part page, the <TITLE> tag accepts one or two title text arguments, 
and the title text is kept on the same line. 


In the SOFTWARE.BROCHURE doctype, the <TITLE> tag accepts one 
or two title text arguments. If you specify only the first argument, the 
title text is placed at the top of the first page and at the bottom of each 
successive page; if you also specify the optional second argument, that 
title text is placed at the bottom of each page. The title text placed at 
the bottom of the page by the SOFTWARE.BROCHURE <TITLE> tag will 
be overridden by the text argument of any subsequent <CHAPTER> tags. 
Refer to VAX DOCUMENT Using Doctypes and Related Tags for more 
information on using the tag in the SOFTWARE.BROCHURE doctype. 


EXAMPLE 
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See the example in the discussion of the <FRONT_MATTER> tag. 


<TITLE_PAGE> 


<TITLE_PAGE> 


Labels the beginning of a title page and enables the title page tags. 














FORMAT <TITLE_PAGE> 

ARGUMENTS ~ None. 

restrictions Valid only in the context of a <FRONT_MATTER> tag. 
If you are using a preface, you must terminate the <TITLE_PAGE> tag before 
you use the <PREFACE> tag. If you are using a copyright page, you must 
terminate the <TITLE_PAGE> tag before you use the <COPYRIGHT_PAGE> tag. 

requ ired <ENDTITLE_PAGE> 


terminator 


DESCRIPTION 


The <TITLE_PAGE> tag labels the beginning of a title page and enables the 
following title page tags: 


¢ <ABSTRACT> 

¢ <ORDER_NUMBER> 

¢  <REVISION_INFO> 

e =6<TITLE> 

DOCUMENT considers the title page to be an online topic. See VAX 


DOCUMENT Producing Online and Printed Documentation for more 
information about online topics. 


Your Bookreader document must contain a title page with the <TITLE_ 

PAGE> and <ENDTITLE_PAGE> tags. The <FRONT_MATTER> tag and the LMF 
(License Management Facility) tags must appear before the <TITLE_PAGE> 
tag. Do not place any tags that generate text before the <TITLE_PAGE> tag. 


EXAMPLE 


See the example in the discussion of the <FRONT_MATTER> tag. 
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<U> 
Labels the user portion of a dialog between user and system in an interactive 
example. 

FORMAT <U> (text) 





ARGUMENTS __ text 


Specifies the text of the user input. 





related tags ¢ <INTERACTIVE> 


e 8 6<S> 





DESCRIPTION _ The <U> tag labels the user portion of a dialog between user and system 
in an interactive example. You must identify both parts of an example 
containing this type of dialog in order to differentiate the two types of text 
in the source code, the output, or both. In Bookreader output, the text that 
you label with the <U> tag appears in boldface. 


In the SOFTWARE doctype, you can use the <U> and <S> tags to 
differentiate the system and user text inside of examples created with 
the <EXAMPLE_SEQUENCE> and <EXI> tags. For more information on this 
doctype, refer to VAX DOCUMENT Using Doctypes and Related Tags. 


SSS ea a a a a a ee ee ee ee 
EXAMPLES The following example shows how to use the <U> tag. 


| <P>The user prompt <U>(send) indicates you can send a command. 
This example produces the following output: 
The user prompt send indicates you can send a command. 


The following example shows how to code dialog between both the system 
and the user. In a dialog, the <S> and <U> tags must be used between 
<INTERACTIVE> and <ENDINTERACTIVE> tags. Note that you should specify, 
within the argument to the <S> tag, whatever space follows the system 
prompt. 


LN | 


<P>The following example of VAXMAIL contains messages from both 
the system and a user of the system: 

<INTERACTIVE> 

<U> (mail) 

<S>(MAIL> )<U>(send) 

<S>(To: )<U>(nodename: :Courtney) 

<S> (SMAIL-E-NOSUCHUSR, no such user COURTNEY at node NODENAME) 
<ENDINTERACTIVE> 


This example produces the following output: 
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<U> 


The following example of VAXMAIL contains messages from both the 
system and a user of the system: 


mail 
MAIL> send 
To: nodename: :Courtney 


SMAIL-~E-NOSUCHUSR, no such user COURTNEY at node NODENAME 
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<UNDERLINE> 


<UNDERLINE> 


Marks a portion of text you want underlined. 





FORMAT <UNDERLINE> (text) 
or 
<UNDERLINE> 
text 


<ENDUNDERLINE> 





ARGUMENTS __ text 


Specifies the text string you want to underline. 





restrictions Because the text string that is marked for underlining is kept on the same 
line in the output, do not make the underline longer than the page width, 
or errors may be generated. 





required <ENDUNDERLINE> — Required if you do not specify the text argument to 
terminator the <UNDERLINE> tag. 





DESCRIPTION — The <UNDERLINE> tag marks a portion of text you want underlined. 


EXAMPLES The following example shows how to use the <UNDERLINE> tag with an 
argument. 
<P>If you use the appropriate flags, your output 


may look like this: 

<P> 

<SAMPLE_ TEXT> 

<UNDERLINE> (The Decline and Fall of the Roman Empire) 
<ENDSAMPLE TEXT> 


This example produces the following output: 


If you use the appropriate flags, your output may look like this: 


The Decline and Fall of the Roman Empire 
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<UNDERLINE> 


The following example shows how to use the <UNDERLINE> tag with the 
<ENDUNDERLINE> tag. This example produces the same output as the first 
example. 


<P>If you use the appropriate flags, your output 

may look like this: 

<P> 

<SAMPLE_ TEXT> 

<UNDERLINE>The Decline and Fall of the Roman Empire<ENDUNDERLINE> 
<ENDSAMPLE_ TEXT> 
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<UPDATE_RANGE> 


<UPDATE_RANGE> 


Marks the location at which a new section of updated pages begins. 





FORMAT 


<UPDATE_RANGE> (start page| { pl \ 





ARGUMENTS 


related tags 


restrictions 


required 
terminator 


start page 
Specifies the page number from the printed documentation of the first 
updated page you want to print. 


end page 

Specifies the last page to be included in a set of update pages. VAX 
DOCUMENT automatically generates point-numbered pages if text within 
the bounds of the <UPDATE_RANGE>(START PAGE) and <UPDATE_RANGE>(END 
PAGE) tags will not fit within those pages. 


EOF 
This keyword specifies that the update range continues to the end of a 
chapter or section. 





e =<MARK> 
e =6©<REVISION> 





The <UPDATE_RANGE> tag has no effect on Bookreader output. 


Valid only in the context of a <REVISION> tag, and the <REVISION> tag must 
specify the keyword UPDATE. If you do not specify the <REVISION> tag, no 
output is generated from the <UPDATE_RANGE> and <ENDUPDATE_RANGE> 
tags. 





<ENDUPDATE_RANGE> 


DESCRIPTION 
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The <UPDATE_RANGE> tag marks the location at which a new section of 
updated pages begins. Files coded with the <REVISION>(UPDATE\ update 
info) tag and containing <UPDATE_RANGE> tags process as follows: 


When the text formatter processes a file that has been marked as an 
update, it processes all text and commands in the file, but does not 
produce actual output for the DVI file, except for those pages marked 
within an update range. 


<UPDATE_RANGE> 


When the text formatter reaches the beginning of an update range, 
it sets the page number to the page number specified as the start 
of the update. Therefore, it is not important that previous versions 
of the text formatter file were modified for pagination during final 
production. All pages processed outside of an update range are not 
output. 


The following rules apply to the placement of the <UPDATE_RANGE> tag: 


If the text on the first update page is in the middle of a text element 
(for example, a paragraph, a list element, a code example), then the 
<UPDATE_RANGE> tag must precede the word of text that is the first 
word on the page. 


If the text on the first update page represents the beginning of a new 
text element (for example, the <P>, <LIST>, <LE>, <CODE_EXAMPLE> 
tags, and so on), you must place the <UPDATE_RANGE> tag immediately 
preceding the tag for the text element. 


If an update range begins on a page that starts with a continued 
table, the file must specify the start of the update range on the odd- 
numbered page preceding the beginning of that table, or (if the table 
begins on an odd-numbered page) the page on which the table begins. 
If these pages are not to be a part of the update, you can discard them. 


If one or more pages before an update range begins contain a floating 
figure or example, you must modify the <FIGURE_ATTRIBUTES> or 
<EXAMPLE_ATTRIBUTES> tags to specify the KEEP argument. This 
prevents the text formatter from floating the figure or example to the 
top of the first update page. ; 


Put a <COMMENT> tag in the file to indicate that the modification was 
made for the purposes of the update only. For example: 


<COMMENT> (KEEP added to example for update only...) 


When the file is subsequently revised, you can remove the KEEP 
arguments. 


When you process a file that contains the <REVISION>(UPDATE) tag, 

the table of contents and index are handled as follows: if you specify 
/CONTENTS and /INDEX on the command line, you receive a table of 
contents and an index even if you do not specify the <CONTENTS_FILE> 
and <INDEX_FILE> tags within the <UPDATE_RANGE> and <ENDUPDATE_ 
RANGE> tags. 


i a I ee ESS Ee a rs eS NL eT ha EI 
In the following example, the updated material begins on page 5 and 
continues through page 24. When page 24 is reached, the page numbering 
becomes 24.1, 24.2, and so on, until the end of the update range is reached. 
You must place the <ENDUPDATE_RANGE> tag in the source file at the 
position corresponding to the place at which an update sequence ends. 


EXAMPLE 
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<UPDATE_RANGE> 


<REVISION> (UPDATE\November 1990) 


<UPDATE_RANGE> (5\24) 
<P> 
The first sentence on page 5 goes ‘here. 


20 or more pages of modified text go here. 


The last sentence on page 24.n goes here. 
<ENDUPDATE_RANGE> ; 
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<UPPERCASE> 


<UPPERCASE> 


Labels text that you want to appear in uppercase in the final output. 





FORMAT <UPPERCASE> (text) 





ARGUMENTS _ text 


Specifies the text you want to appear in uppercase. 





related tags * <LOWERCASE> 





DESCRIPTION _ The <UPPERCASE> tag labels text that you want to appear in uppercase 
. in the final output. In your book, there may be a text element, such as a 
heading, that normally appears in lowercase. Use the <UPPERCASE> tag if 
you need to overcome the default case in one of your tags and ensure that 
the result in the final ee appears in uppercase. 


EXAMPLE In the following example, assume that the doctype being used causes the 
<HEAD2> tag to output a heading that is in lowercase, no matter what the 
case of the text passed to it. The <UPPERCASE> tag overrides the default in 
this <HEAD2> tag. 


<HEAD2> (Here is an example of <UPPERCASE> (uppercase) text.) 


This example produces the following output: 
Here is an example of UPPERCASE text. 
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<USER_|_MESSAGE> 





<USER_I_MESSAGE> 


Sends an informational message to the terminal, .LIS, or .LOG file during 
processing of a file. 





FORMAT 


<USER_|_MESSAGE> (info text) 





ARGUMENTS 


related tags 


restrictions 


info text 
Specifies the text you want to appear on the terminal or in the .LIS or 
.LOG file. 





¢ <USER_W_MESSAGE> 





For batch processing, you must process the file with the /LOG qualifier on 
the command line in order to see any <USER_I_LMESSAGE> tag messages. 


The message text is limited to 150 characters. 


DESCRIPTION 
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Note: 


The <USER_I_MESSAGE> tag sends an informational message to the 
terminal, .LIS, or .LOG file during processing of a file. 


If you process the file interactively, the message will appear on your 
screen. If you process the file interactively and use the /LIST qualifier on 
the command line, the message is also listed in the .LIS file. 


If you process the file in batch and specify the /LOG qualifier on the 
command line, the message is listed in the .LOG file. 


You can use the tag to broadcast any important information that should be 
noted during processing; for example, you might use it as a reminder that 
you still must add information to a file. 


The tag translator displays the line number and the file name in which 
the tag appears. The message is output in the following format: 


STAG-I-USER_IMSG, mmmmmmmmmmmmmmmmmm 
Line is nnn of file ffffffrffrrfrfft 


If you want to generate only a few messages, you might choose 
to use the <USER_W_MESSAGE> tag and not process the file with the 
additional qualifier. 


<USER_|_ MESSAGE> 





EXAMPLE The following example shows how to use the <USER_I_LMESSAGE> tag to flag 
a section of a file that requires further work. 


<USER_I_MESSAGE> (Section 2 is incomplete and requires 
information from Tom Smith.) 


Suppose the file containing this message is called “Chapter_1.SDML.” 
Depending on how you process this file, the message appears on your 
screen, in the .LIST file, or in the .LOG file as follows: 


STAG-I-USER_IMSG, Section 2 is incomplete and requires information 
from Tom Smith. 
Line is 68 of file part2.sdml 
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<USER_W_MESSAGE> 


<USER_W_MESSAGE> 


Sends a warning message to the terminal, .LIS, or .LOG file during processing 
of a file. 





FORMAT 


<USER_W_MESSAGE>(warning text) 





ARGUMENTS 


related tags 


restrictions 


warning text 
Specifies the text you want to appear on the terminal or in the .LIS or 
.LOG file. 





e = =<USER_I_LMESSAGE> 





For batch processing, you must process the file with the /LOG qualifier on 
the command line in order to see any <USER_W_MESSAGE> tag messages. 


The message text is limited to 150 characters. 





DESCRIPTION 
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Note: 


The <USER_W_MESSAGE> tag sends a warning message to the terminal, 
.LIS, or .LOG file during processing of a file. 


If you process the file interactively, the message will appear on your 
screen. If you process the file interactively and use the /LIST qualifier on 
the command line, the message is also listed in the .LIS file. 


If you process the file in batch and specify the /LOG qualifier on the 
command line, the message is listed in the .LOG file. 


This type of message is counted by the tag translator as a warning 
message. After thirty warning messages, tag translation halts. 
Therefore, use the <USER_W_MESSAGE> tag for generating messages 
only if you are issuing a few messages. For a file that contains 
many messages, tag messages with <USER_I_LMESSAGE> tags and 
process the file with the /LOG qualifier. 


You can use the tag to broadcast any important information that should be 
noted during processing; for example, you might use it as a reminder that 
a part of the file is incomplete. 


The tag translator displays the line number and the file name in which 
the tag appears. The message is output in the following format: 


STAG-W-USER_WMSG, at tag <USER_W_MESSAGE> on line nnn of file 
fff¢CrftTf 
Tommi 


<USER_W_MESSAGE> 





EXAMPLE The following example shows how to use the <USER_W_MESSAGE> tag to 
identify a notice in a file. 


<USER_W_MESSAGE> (Reviewers: Please note missing parameters here.) 


Suppose the file containing this message is called “Reviewers_copy.SDML.” 
Depending on how you process this file, the message appears on your 
screen, in the .LIST file, or in the .LOG file as follows: 

$TAG-W-USER_WMSG, at tag USER_W_MESSAGE on line nn of file 


Reviewers copy.SDML. 
Reviewers: Please note missing parameters here. 


1-281 


<VALID_BREAK> 


<VALID_BREAK> 


Labels a permissible page break within a monospaced example (created with 


the <CODE_EXAMPLE>, <DISPLAY>, <INTERACTIVE>, or <LINE_ART> tags). 





FORMAT 


<VALID_BREAK> 





ARGUMENTS 


related tags 


restrictions 


None. 





° <CODE_EXAMPLE> 
<DISPLAY>—in the SOFTWARE doctype 
<INTERACTIVE> 


<LINE_ART> 





Valid only in the context of monospaced examples created with the <CODE_ 
EXAMPLE>, <DISPLAY> (in the SOFTWARE doctype), <INTERACTIVE>, or 
<LINE_ART> tags. 


DESCRIPTION 


The <VALID_BREAK> tag labels a permissible page break within a 
monospaced example (created with the <CODE_EXAMPLE>, <DISPLAY>, 
<INTERACTIVE>, or <LINE_ART> tags). 


The text formatter attempts to keep an example together on a single page. 
If there is not enough room for an example on the current page, the text 
formatter chooses page breaks using blank lines in the example as valid 
places to break. If your example contains no blank lines, or if you want 
to specify better breaking points, you can use the <VALID_BREAK> tag to 
specify the places that are acceptable page breaks. 


This tag has no effect for Bookreader output. 


EXAMPLE 


<INTERACTIVE> 
<S>($) 


The following example shows how to use the <VALID_BREAK> tag. 


<U> (@SYSSSYSTEM: SHUTDOWN) 


<S> ( SHUTDOWN -- Perform an Orderly System Shutdown) 


<ELLIPSIS> 


<S> (CENTRAL, PRINTER, TAPES, DISKS, DEVICES, CARDS, NETWORK, OPER1) 
<S>(OPER3, OPER4, OPERS, OPER6, OPER7, OPER8, OPER9, OPER10, OPERI1,) 


<S> (OPER12) 
<VALID_BREAK> 


1-—282 


<VALID_BREAK> 


<S>(SSHUTDOWN-I-DISLOGINS, Interactive logins will now be disabled.) 
<S>(%SET-I-INTSET, login interactive limit = 0 current interactive value = 17) 
<S>(SSHUTDOWN-I-SHUTNET, The DECnet network will now be shut down.) 

<S> (SSHUTDOWN-I-STOPQUEMAN, The queve manager will now be stopped.) 
<ENDINTERACTIVE> 
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<VALID_TABLE_ROW_BREAK> 


<VALID_TABLE_ROW_BREAK> 


Marks a permissible place that a first-level table row, not a nested table row, 
may be broken across pages. 





FORMAT <VALID_TABLE_ROW_BREAK> 





ARGUMENTS __ Nore. 





related tags ¢ <NESTED_TABLE_BREAK> 





restrictions Valid only in the context of a <TABLE> tag. 


Valid only in the last column of a 2- or 3-column, first-level table; you 
cannot specify this tag in a nested table. 


DESCRIPTION _ The <VALID_TABLE_ROW_BREAK> tag marks a permissible place that a first- 
level table row, not a nested table row, may be broken across pages. If 
you do not use the <VALID_TABLE_ROW_BREAK> tag inside a long table row, 
the text formatter tries to keep all the text on the same page of output: 
and might issue an error message. In extreme cases, the text formatter 
could run out of memory trying to process the table row and terminate 
processing. . 


This tag has no effect for Bookreader output. - 


EXAMPLE The following example shows how to use the <VALID_TABLE_ROW_BREAK> 
tag in a table with a long table row. . 


<TABLE> 

<TABLE ATTRIBUTES> (MULTIPAGE) 

<TABLE _SETUP>(2\9) 

<TABLE ROW>(Item\Text that goes on for several paragraphs. 
<VALID_TABLE_ROW_BREAK> 

Text that is still inside the first table row. 

<P> 

<VALID_TABLE ROW_BREAK> 

The last paragraphs for this table row.) 

<ENDTABLE> 
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<VARIABLE> 


<VARIABLE> 


Labels a program variable or number you want to typographically distinguish. 





FORMAT <VARIABLE> (variable name) 





ARGUMENTS _ variable name 
Specifies the name of the variable to be typographically distinguished. 





related tags * <KEYWORD> 





DESCRIPTION The <VARIABLE> tag labels a program variable or number you want to 
typographically distinguish. Use this tag to format a variable consistently 
throughout a document and a document set. 





EXAMPLE The following example shows how to use the <VARIABLE> tag. 


<P>At this point in the processing, 
<VARIABLE> (VERSION _NUMBER) has the 
value of 2. 
This example produces the following output: 


At this point in the processing, VERSION_NUMBER has the value of 2. 
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<VBAR> 





<VBAR> 


Specifies a vertical bar anywhere in your file. You must use this tag, however, 
to specify a vertical bar in an argument to a tag. 





FORMAT <VBAR> 





ARGUMENTS — ‘None. 





related tags ¢ The following tags label other characters that you must tag when they 
occur in an argument to a tag: 


<AMPERSAND> 
<BACKSLASH> 
<CPAREN> 
<OPAREN> 





restrictions Valid only in an argument to a tag. 





DESCRIPTION _ The <vBAR> tag specifies a vertical bar anywhere in your file. You must 
use this tag, however, to specify a vertical bar in an argument to a tag. 
If you use a literal vertical bar within an argument to a tag, the tag 
translator reads the vertical bar as beginning a section of text it should 
treat literally. This is because the tag translator uses a vertical bar (| ) 
to begin a quoted string. The vertical bar may prevent the tag translator 
from correctly evaluating a tag, thus causing an error in your output. 


EXAMPLE The following example shows how to use the <VBAR> tag. 
<SUBHEAD1>(Labeling the Vertical Bar (<VBAR>) Within Your 
Code\label_vbar) 
<P>To pass a vertical bar (|) in an argument to a tag through 
to your output, 
This example produces the following output: 
Labeling the Vertical Bar (|) Within Your Code 


To pass a vertical bar (| ) in an argument to a tag through to your 
output, ... 
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<X> 











<X> 
Creates a main index entry. For a printed book, the <x> tag creates a 
reference to the page on which this tag appears. For a book you create 
for Bookreader, the <x> tag creates a hotspot on the index entry that you 
click on to display the associated text. 

FORMAT <X> (index entry[ \ attribute]) 

ARGUMENTS __ index entry 


Specifies the index entry you want to appear in the index. The 
capitalization you use is the capitalization that appears in the index. 


attribute 

This is an optional argument. It specifies the attributes that control 
the sorting and formatting of the index entry. Each attribute must be a 
separate argument. 


Attribute Function 
<XAPPENDs=(string) Appends the specified string to the page reference in the 
index. 


You must leave a space between the left parenthesis of 
the <XAPPEND> tag’s argument and the word you want to 
append, in order to have a space in the output between the 
page number and the appended word.. 


In page-range references, append the string to the 
<X>(...\ END) tag, not to the <X>(...\ BEGIN) tag. The 
<XAPPEND> tag has no effect for Bookreader output. 


BEGIN Begins a page-range reference. When you use this attribute, 
you must pair it with a following <X> tag that has identical 
text (including capitalization) and the END aitribute. BEGIN 
and END have no effect for Bookreader output. 


BOLD Causes the page reference number to appear in boldface. 
This is distinct from any boldfacing that appears in the text of 
the index entry itself. Use the <EMPHASIS> tag if you want 
to bold the index entry. BOLD has no effect for Bookreader 
output. 


BOTH Specifies an index entry that you want to appear in both a 
single-document and a master index. BOTH has no effect for 
Bookreader output. 


END Ends a page-range reference. When you use this attribute, 
you must pair it with a previous <X> tag that has identical 
text (including capitalization) and the BEGIN attribute. BEGIN 
and END have no effect for Bookreader output. 
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<X> 


related tags 


restrictions 


Attribute Function 


ITALIC Causes page reference numbers to appear in italics in your 
index entry. If you specify both BOLD and ITALIC, the entry 
is output in bold italics. Use the <EMPHASIS> tag if you want 
to bold the index entry. ITALIC has no effect for Bookreader 
output. 


MASTER Specifies that an index entry appear only in a master index. 
A master index is an index generated by specifying /MASTER 
on the DOCUMENT command line. By default, the entries 
appear only in a single-document index. Using /MASTER 
allows you to specify different entries for a single book’s index 
and for the master index of the document set. MASTER has 
no effect for Bookreader output. 


NOMASTER Specifies that an index entry appear only in a single- 
document index and not in a master index. NOMASTER 
has no effect for Bookreader output. 


<XSORT>(string) Uses the specified string as the sort key when placing this 
entry in the index, forcing the entry to sort in a place different 
from where it would by default. 





e 6<XS> 
© <XSUBENTRY> 


e <Y> 





Invalid in informal code examples. Using this tag in a code example 
interferes with the formatting of the example. 


In tables, place <X> tags directly next to the items you want to index 
(within the arguments to the <TABLE_ROW> tag, so that the page references 
will be correct if the table breaks across pages), or after the <TABLE_HEADS> 
or <TABLE_SETUP> tags. 


In tables you create for Bookreader, place <X> tags after <TABLE_HEADS>, 
<TABLE_ROW>, or <TABLE_SETUP> tags so that the index entry points to the 
table pop-up window. 


If you want an index entry to point to a small section of text, you must 
place the index tag within the section of text, so that the index entry 
refers to the correct page. 


If you want an index entry to point to a large section of text denoted by a 
heading, you must place the index tag after the relevant <HEADn> tag, not 
before it, so that the index entry refers to the correct page. 


DESCRIPTION 
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The <X> tag creates a main index entry in either a single-document or 

a master index. A master index is an index generated by specifying 

the /MASTER_INDEX qualifier on the DOCUMENT command line; a 
single-document index is an index generated by specifying /INDEX on the 
command line. 


<X> 


For a printed book, the <X> tag creates a reference to the page on which 
this tag appears. For a book you create for Bookreader, the <X> tag creates 
a hotspot on the index entry that you click on to display the associated 
text. The entry is composed of the main entry and optional subentries, 
which you specify in the first argument to the tag using the <XSUBENTRY> 
tag. See the <XSUBENTRY> tag description for more information. 


Code your index entries within the information you want the entry to point 
to, which ensures that the index will point to the correct page or section of 
information. 


You can control how the index entry is sorted and how it appears by 
specifying particular keywords as attribute arguments. 


For example, the <XAPPEND> attribute is useful when appending text to the 
end of a page reference, as when referring to an example (5-4ex) or to a 
table (9-8tab). You can also use the <XAPPEND> attribute to append “ff” or 
“passim”, for example, to the page number. The <XAPPEND> attribute has 
no effect for Bookreader output. 


The appended string is boldfaced or italicized if its page reference is 
boldfaced or italicized. You can use the BOLD and ITALIC attributes 
together. BOLD and ITALIC have no effect for Bookreader output. 


You can create an index entry for several inclusive pages by using the 
BEGIN and END attribute. When using a BEGIN and END pair, you 
must be certain that the index entries are identical and that any other 
attributes you specify are the same for each entry, as well. The BEGIN 
and END pair have no effect for Bookreader output. 


If you have an index entry for which you want to control the sorting, use 
the <XSORT> attribute. For example, you can sort the word “Cat” under 
the “-D-” entries. If you want to control the sorting of nonalphabetic 
characters, use the INDEX=SORT= qualifier on the DOCUMENT 
command line. See Appendix A for more information on the command 
line. 


You can specify that an index entry appear in a master index by using the 
MASTER attribute. No entry marked with the MASTER attribute appears 
in the single-document index. 


You can specify an index entry that you do not want to appear in a master 
index by using the NOMASTER attribute. This attribute limits the entry 
to appear only in a single-document index. 


You can specify an index entry that you want to appear in both a single- 
document and a master index by using the BOTH attribute. 


If you do not specify an attribute, the entry appears only in the single- 
document index unless you override this default with the following 
DOCUMENT command line qualifiers: 


\INDEX=OVERRIDE_MASTER Creates a single-document index 
containing both master and single- 
document index entries. 
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<X> 


Table 1-5 


<X> Tag 
Attributes 

none 

BOTH 

MASTER 

NOMASTER 


1-290 


\MASTER_INDEX=OVERRIDE_MASTER Creates a master index containing 
both master and single-document 
index entries. 


An index entry that you label with the NOMASTER attribute is included 
only in the single-document index regardless of which “OVERRIDE” 
qualifier you use on the command line. 


An index entry that you label with the BOTH attribute is included in 
both the single-document and the master index regardless of which 
“OVERRIDE” qualifier you use on the command line. 


Table 1-5 summarizes how the <X> tag attributes and the command line 
indexing options for a single-document and a master index interact. An 
“X” specifies that an index entry with the listed tag attribute runs with 
the command line option to produce an index. 


interaction of <X> Tag Arguments and Command Line Indexing Options 


Command Line Options 


For a Single-document Index For a Master Index 


[INDEX /INDEX=OVERRIDE /MASTER /MASTER=OVERRIDE 


X 
X 


X X 
X X X 
X X X 
X 


For example, if you want to specify that certain index entries appear in a 
master index but not in a single-document index, code the entries using 
the MASTER attribute. 


If you want to generate a single-document index that includes 
index entries that you coded with the MASTER attribute, use the 
/JINDEX=OVERRIDE qualifier on the command line. 


If you want to generate a master index that includes index entries that 
you coded without the MASTER attribute, use the /MASTER=OVERRIDE 
qualifier on the command line. 


If you want to generate a master index that includes some of your coded 
index entries (both with and without using the MASTER attribute) while 
excluding other entries, do the following: 


1 Edit your .SDML file by adding the NOMASTER attribute to the 
entries you want excluded. | 


2 Process your book using the /MASTER=OVERRIDE qualifier on the 
command line. 


<X> 


If you want to generate a single-document index that includes some but 
not all of the entries you coded using the MASTER attribute, without 
having to remove the MASTER attribute from the entries you want to 
include, do the following: 


1 Edit your .SDML file by changing the MASTER attribute to BOTH for 
those entries you want to include. 


2 Process your book to generate a single-document index by using the 
/AINDEX qualifier on the command line. 


Consider the following when indexing for Bookreader output: 


e Be sure to place your index entries within the information you want 
the entry to point to, which ensures that the entry in the index will 
point to the correct topic of information. 


¢ You can place index tags anywhere in your table, except directly after 
the <TABLE> tag, or else the entries will point to the previous text 
instead of to the table in the pop-up window. 


e In formal examples and formal figures, place the index tags before 
the <ENDEXAMPLE> or <ENDFIGURE> tag, so that clicking on the entry 
in the index causes the actual example or figure to pop up. Do not 
place index entries within a code example, or the code example may 
not be formatted correctly. 


Refer to Appendix A for more information on using the /INDEX qualifier 
on the DOCUMENT command line. 


EXAMPLES 


The following example shows how to position the <X> tag to provide an 
index entry for a chapter. 


<GHAPTER> (Creating Routines\creating_routine_sec) 
<X> (Routines<XSUBENTRY>creation of) 


In order to create a routine, you must first . 


If the previous text appeared on page 11-2, the <X> tag would create the 
following output under the heading “R”: 


Routines 
creation of, 11-2 


The following example shows how to create an inclusive index entry using 
the BEGIN and END attributes. 


<X>(File structure\begin) 


<X> (File structure\end) 


This example produces the following output under the heading “F”: 


File structure, 5-4 to 5-7 
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<X> 


The following example shows how to use the <XAPPEND> attribute. Notice 
that you must leave a space between the left parenthesis of the <XAPPEND> 
attribute’s argument and the word you want to append, in order to have a 
space in the output between the page number and the appended word. 


3] <X>(File structure\begin) 


<X> (File structure\end\<XAPPEND> ( passim) ) 


This example produces the following output under the heading “F”: 
File structure, 5-4 to 5-7 passim 


The following example shows how to code multiple subentries for a 
particular main entry. 


4 <X> (Debugger<XS>features of) 
<X> (Debugger<xXS>exiting from) 


<X> (Debugger<XS>invoking) 


This example produces the following output under the heading “D”: 


Debugger 

exiting from, 2-4 

features of, 1-7 

invoking, 3-9 
The following example shows where to put an index tag in a table, and 
creates an index entry that correctly specifies the page that the text 
“bananas” appears on, no matter where VAX DOCUMENT breaks the 
table. 


5] <TABLE_ROW> (apples\oranges\pears) 
<TABLE ROW> (<X> (Tropical fruits<XS>bananas) bananas\pineapples\mangos) 
<TABLE_ROW> (blackberries\blueberries\strawberries) 


This example produces the following output under the heading “T”: 


Tropical fruits 
bananas, 3-21 


The following example shows how to use the <XSORT> attribute. “Tsar” is 
placed with the “C” entries after “Czar” rather than with the “T” entries. 


6 <X> (Tsar<XSUBENTRY>country of\<XSORT> (Czar) ) 
This example produces the following output: 
Cat, 3-6 
Czar, 1-16 


Tsar 
country of, 3-21 
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<X> 


The following example shows how to code an index entry that you want to 
appear only in a master index. 


7| <X> (Classical music\MASTER) 


The following example shows how to code an index entry that you want to 
appear only in an individual index and not in a master index. 


3 <X> (Jazz music\NOMASTER) 


The following example shows how to code an index entry that you want to 
appear in both an individual and a master index. 


9) <X> (Alternative rock music\BOTH) 
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<XS> 


<XS> 


Separates the main index entry from the first subentry, the first subentry from 
the second, and the second subentry from the third. Used within the argument 
to the <X> or <Y> tags. For a printed book, the <xS> tag creates a reference 
to the page on which the tag appears. For a book you create for Bookreader, 
the <xS> tag creates a hotspot on the index entry with no page reference. 
(The <XxS> tag is identical to the <XSUBENTRY> tag.) 





FORMAT 


<XS$>(subentry-1[<xs>subentry-2[<xs>subentry-3]]) 





ARGUMENTS 


related tags 


restrictions 


subentry 
Specifies up to three subentries you want to appear in the index. The 
capitalization you use is the capitalization that appears in the index. 





e =6<X> 
© <XSUBENTRY> 


e  6<Y> 





Valid only within the argument to an <X> or <Y> tag. 


You can use a maximum of three subentries in the index. 


DESCRIPTION 
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The <XS> tag separates the main index entry from the first subentry, the 
first subentry from the second, and the second subentry from the third. 
For example: 


<x>(main entry<xs>subentry-1<xs>subentry-2<xs>subentry-3) 


For a printed book, the <XS> tag creates a reference to the page on which 
the tag appears. For a book you create for the Bookreader, the <XS> tag 
creates a hotspot on the index entry with no page reference. 


An index entry for a book you create for Bookreader that contains more 
than one reference to another section displays all the index selections in a 
separate pop-up window. See VAX DOCUMENT Producing Online and 
Printed Documentation for a graphic example. 


<XS> 





EXAMPLES The following example shows how to use the <XS> tag. 
| <X> (Vehicles<xXS>use of) 


If the previous index tags appeared on page 3-1, they would create the 
following index entry under the heading “V”: 


Vehicles 
use of, 3-1 


” 


The following example shows how to use the <XS> tag to create a “See also 
entry. 


2 <X>(File structure designators) 
<Y>(File structure designators<XS>See also Header blocks) 


If the previous tags appeared on page 1-3, they would create the following 
index entry under the heading “F”: 


File stucture designators, 1-3 
See also Header blocks 


The following example shows how to code multiple subentries for a 
particular main entry. 


3 <X> (Debugger<XS>features of) 
<X> (Debugger<XS>exiting from) 


<X> (Debugger<XS>invoking) 
The previous tags produce the following entries under the heading “D”: 
Debugger 
exiting from, 1-7 
features of, 2-4 


invoking, 3-9 


The following example creates unnumbered index entries (because of the 
<Y> tag, which you use for unnumbered “See” and “See also” entries). 


4 <Y>(CORP-AUTO report<xS>See Reports<XS>See also Cars) 


Regardless of what page the previous tags appear on, they produce the 
following output under the heading “C”: 
CORP-AUTO report 


See Reports 
See also Cars 
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<XSUBENTRY> 


<XSUBENTRY> 


Separates the main index entry from the first subentry, the first subentry 
from the second, and the second subentry from the third. Used within the 
argument to the <X> or <Y> tags. For a printed book, the <XxSUBENTRY> tag 
creates a reference to the page on which the tag appears. For a book you 
create for Bookreader, the <XSUBENTRY> tag creates a hotspot on the index 
entry with no page reference. The <XSUBENTRY> tag is identical to the <xS> 
tag. | 





FORMAT 


<XSUBENTRY>(subentry-1/<xSuBENTRY>subentry-2 
[<XSUBENTRY>Subentry-3]]) 





ARGUMENTS 


related tags 


restrictions 


subentry 
Specifies up to three subentries you want to appear in the index. The 
capitalization you use is the capitalization that appears in the index. 





e <X> 
e <XS> 
e 6<Y> 





Valid only within the argument to an <X> or <Y> tag. 


You can use a maximum of three subentries in the index. 


DESCRIPTION 
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The <XSUBENTRY> tag separates the main index entry from the first 
subentry, the first subentry from the second, and the second subentry 
from the third. For example: 


<X>(main entry<xsuBentRY>Subentry-1 <xsuBENTRY>SUbentry-2<xsuBENTRY>Subentry-3) 


For a printed book, the <XSUBENTRY> tag creates a reference to the page 
on which the tag appears. For a book you create for Bookreader, the 
<XSUBENTRY> tag creates a hotspot on the index entry with no page 
reference. . 


An index entry for a book you create for Bookreader that contains more 
than one reference to another section displays all the index selections in a 
separate pop-up window. See VAX DOCUMENT Producing Online and 
Printed Documentation for a graphic example. 


<XSUBENTRY> 





EXAMPLES The following example shows how to use the <XSUBENTRY> tag. 


<X> (Vehicles<XSUBENTRY>use of) 


If the previous index tags appeared on page 3-1, they would create the 
following index entry under the heading “V”: 


Vehicles 


use of, 3-1 


The following example shows how to use the <XS> tag to create a “See also” 
entry. 


2 <X> (File structure designators) 
<Y>(File structure designators<XSUBENTRY>See also Header blocks) 


If the previous tags appeared on page 1-3, they would create the following 
index entry under the heading “F”: 


File stucture designators, 1-3 
See also Header blocks 


The following example shows how to code multiple subentries for a 
particular main entry. 


3 <X> (Debugger<XSUBENTRY>features of) 
<X> (Debugger<XSUBENTRY>exiting from) 


<X> (Debugger<XSUBENTRY>invoking) 


The previous tags produce the following entries under the heading “D”: 


Debugger 
exiting from, 1-7 
features of, 2-4 
invoking, 3-9 


The following example creates unnumbered index entries (because of the 
<Y> tag, which you use for unnumbered “See” and “See also” entries). 


<Y>(CORP-AUTO report<XSUBENTRY>See Reports<XSUBENTRY>See also Cars) 


Regardless of what page the previous tags appear on, they produce the 
following output under the heading “C”: 


CORP-AUTO report 


See Reports 
See also Cars 
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<Y> 








<Y> 
Used with the <XSUBENTRY> tag to create a main index entry and a subentry 
that has no page reference for a printed book and no hotspot for a book 
you create for Bookreader. Use the <Y> and <XSUBENTRY> tags for cross- 
references (“See” or “See also” entries) to other index entries. 

FORMAT <Y>/(index entry| \ attribute]) 

ARGUMENTS __ index entry 


related tags 


restrictions 
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Specifies the main entry and subentries that appear in the index. The 
capitalization you use is the capitalization that appears in the index. 


attribute 

This is an optional argument. It specifies the attributes that control the 
sorting of the index entry. You can specify a maximum of two attribute 
arguments. Each attribute must be a separate argument. The possible 
attributes follow: 


Attribute Function 


BOTH Specifies an index entry that you want to appear in both a 
single-document and a master index. BOTH has no effect for 
Bookreader output. 


MASTER Specifies that an index entry appear only in a master index. A 
master index is an index generated by specifying /MASTER on 
the DOCUMENT command line. By default, the entries appear 
only in a single-document index. Using /MASTER allows you 
to specify different entries for a single book’s index and for the 
master index of the document set. MASTER has no effect for 
Bookreader output. 


NOMASTER Specifies that an index entry appear only in a single-document 
index and not in a master index. NOMASTER has no effect for 
Bookreader output. 

<XSORT>(string) Uses the specified string as the sort key when placing this 
entry in the index, forcing the entry to sort in a place different 
from where it would by default. 








e@ <X> 
e  =6<XS$> 
e <XSUBENTRY> 





Invalid in informal code examples. Using this tag in a code example 
interferes with the formatting of the example. 


<Y> 


a Pea cL a a I a 
DESCRIPTION _ Use the <Y> tag with the <XSUBENTRY> tag to create a main index 
entry and a subentry that has no page reference for a printed book 
and no hotspot for a book you create for Bookreader. Use the <Y> and 
<XSUBENTRY> tags for cross-references (“See” or “See also” entries) to other 
index entries. You specify the subentries by using the <XSUBENTRY> tag 
within the argument to the <Y> tag. See the <XSUBENTRY> tag description 
for more information. 


The <Y> tag subentries sort alphabetically at the top of the subentry list, 
before the <X> tag subentries; that is, cross-references to a topic are listed 
before its subtopics. 


For information on how to use the MASTER, NOMASTER, BOTH, and 
<XSORT> attributes, see the <X> tag description. 
EXAMPLES The following example shows how to use the <Y> tag. 


H <X>(File structure designators) 
<Y>(File structure designators<XSUBENTRY>See also Header blocks) 


If the previous index tags appeared on page 1-3, they would create the 
following index entry under the heading “F”: 


File stucture designators, 1-3 
See also Header blocks 


The following example shows how to use the <Y> tag to create an 
unnumbered index entry. 


2 <Y>(File structure designators<XSUBENTRY>See also Header blocks) 


The previous tags create the following output under the “F” entry: 


File stucture designators 
See also Header blocks 


The following example shows how to code multiple “See also” references 
for a particular main entry. 


3 <Y> (Debugger<xXS>See also Debugger commands; Debugging; /DEBUG 
qualifier) 


The previous tags produce the following output under the heading “D”: 


Debugger 
See also Debugger commands; Debugging; /DEBUG qualifier 


The following example shows how to use the <Y> tag to sort the entry 
“Cat”. 


<Y>(Cat<XSUBENTRY>See also Feline\<XSORT> (Animals) ) 


The previous tags produce the following output, where “Cat” is placed with 
the “A” entries after “Animals” rather than with the “C” entries: 


Cat 
See also Feline 
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A, VAX DOCUMENT Command Summary | 


This appendix lists and describes all the VAX DOCUMENT commands. 
The appendix is separated into two command summarys: 


¢ DOCUMENT[/FORMATTER] 
Starts the VAX DOCUMENT formatting system. 


You can find a summary of this information by typing the following 
command at the DCL prompt: 


$ HELP DOCUMENT [/FORMATTER] 
° DOCUMENT/GENERATE_SYMBOL 
Starts the VAX DOCUMENT symbol generator. 


You can find a summary of this morination by typing the mae 
command at the DCL prompt: 


$ HELP DOCUMENT/GENERATE_SYMBOL 


The HELP file also provides a summary of commands for using the 
Graphics Editor. You can type the following command at the DCL prompt: 


$ HELP ‘DOCUMENT/GRAPHICS 


See the VAX DOCUMENT Graphics Editor User’s Guide for more 
information about the Graphics Editor. 
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DOCUMENT[/FORMATTER] 


DOCUMENT[/FORMATTER] 


Starts the VAX DOCUMENT formatting system. 





FORMAT DOCUMENT[/FORMATTER] _ input-file doctype 
destination 
Command Qualifier Default 
/{NOJBAT CH[=qualifier-keyword] /NOBATCH 
/CONDITION=condition-name None. 
/{NOJCONTENTS /NOCONTENTS 


/CONTENTS (Bookreader) 
/[NOJDEVICE_CONVERTER|=device-keyword] /DEVICE_CONVERTER 





/A{NOJDIAGNOSTICS/=file-spec] /NODIAGNOSTICS 
/ELEMENT=tfile-spec None. 
/INCLUDE=file-spec None. 
/{[NOJINDEX[=index-keyword] /NOINDEX 
/[NO]JKEEP|=tfiletype-keyword] /NOKEEP 
/A{NOJLIST[=file-spec] /NOLIST 
ANOJLOG /LOG 
/[NO]MAP|=file-spec] /NOMAP 
/A{NOJMASTER_ INDEX[=index-keyword] /NOMASTER_INDEX 
/OUTPUT=file-spec See text. 
/[NOJPRINT[=qualifier-keyword] /NOPRINT 
/PROFILE=file-spec None. 
/[NOJSYMBOLS=tfile-spec /NOSYMBOLS 
ANOJTAG_TRANSLATOR /TAG_TRANSLATOR 
AINO]TEXT_FORMATTER /TEXT_FORMATTER 
restrictions The /FORMATTER command is the default. It is positional; if you use it, 


it must immediately follow DOCUMENT. 


PARAMETERS _input-file 
Specifies the input file to be processed. You cannot use wildcards in the 
input file specification. 


The default file type of the input file is SDML. If you specify qualifiers, 
VAX DOCUMENT determines the default file type based on the qualifiers 
and the destination keyword you specify. Table A—1 lists the qualifiers, the 
default destinations, and the default file types. 


Destination Keyword 


BOOKREADER 
HELP 

LINE 

LNO3 
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Table A—-1 Default File Types 





VAX DOCUMENT Default Destination Default Input 
Qualifiers Used Keyword Used File Type 
None. Any SDML 
/TAG_TRANSLATOR Any SDML 
{ /NOTAG_TRANSLATOR \ Any TEX 
/TEXT_FORMATTER 
/NOTAG_TRANSLATOR BOOKREADER DVI_LNO3 
/NOTEXT_FORMATTER LNO3 DVI PS 
/DEVICE_CONVERTER PS DVI LINE 
LINE DVI_LINE 
MAIL DVI_LINE 
TERMINAL 
/NOTAG_TRANSLATOR LNO3 DVI 
/NOTEXT_FORMATTER PS BOOKREADER 
/NODEVICE_CONVERTER LINE LNO3 
/PRINT MAIL PS 
TERMINAL LINE 
TXT 
TERM 


‘Braces in this table indicate that the enclosed qualifiers occur together on the 
command line. 


doctype 

The doctype you indicate on the command line determines both the style 
of your output and the SDML tags you can use. Note that some tage are 
valid only in specific doctypes. 


A number of doctypes have a choice of designs. A design is a specialized 
form of a doctype. You specify the design keyword immediately after 
the doctype keyword and separate them with a period (.); for example, 
SOFTWARE.REFERENCE. You can abbreviate the doctype keyword; for 
example, you could shorten SOFTWARE.REFERENCE to S.R, as long as 
each keyword is unique. 


See VAX DOCUMENT Using Doctypes and Related Tags for more 
information on doctypes and doctype-specific tags. 


destination 

Specifies the output device destination for the document. VAX 
DOCUMENT supports the following output destinations; your local 
destinations may be different. 


Formatted For Output File Type 
Bookreader output .DECW$BOOK 
Building a Help file -HLP 

A line printer -LINE 

An LNOS laser printer -LNO3 
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Destination Keyword 


PS 


MAIL 
TERMINAL 


Formatted For Output File Type 


Any Digital-supported PostScript output .PS 
device, such as the PraintServer 40 or the 
LNO3R ScrietPRinteR 


Sending through the VMS Mail Utility TXT 
A standard ANSI terminal, such as the .TERM 
VT-100 


You can abbreviate the destination keyword. For example, you could 
abbreviate LN03 to LNO, or even LN, as long as that destination is unique. 


Note that monospaced fonts defined for all the sizes are provided for text 
fonts in the POSTSCRIPT destination. 


~ You can have additional local destination keywords defined at your site. 


See your VAX DOCUMENT system administrator for information on local 
destination keywords. 


DESCRIPTION 


DOCUMENT is the command you specify to start VAX DOCUMENT. It 
requires three parameters: 


¢ Input File 


Specifies the input file for VAX DOCUMENT. By default, this file is an 
SDML file containing SDML tags; however, it can also be one of the 
intermediate files generated by VAX DOCUMENT. 


¢ Doctype 


Specifies the document type for which the input file will be processed. 
This keyword specifies the kind of document you want to create (a 
letter, a software manual, a journal article, and so on). 


¢ Destination 


Specifies the final processing destination for the input file. This 
keyword specifies a format used by a printer, Bookreader, a terminal, 
or the VMS Mail Utility. 


You can use qualifiers to the DOCUMENT command to create an index, 
master index, and table of contents, and to modify the default processing 
of your input file. 





QUALIFIERS 
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/BATCH[=(qualifier keyword[, qualifier keyword...])] 


/NOBATCH 

Specifies whether VAX DOCUMENT should be run interactively or run as 
a batch job. The default qualifier is /NOBATCH, which specifies that VAX 
DOCUMENT be run interactively. 


The /BATCH qualifier submits a job to SYS$BATCH with a job name that 
has the same file name as the input-file, prefixed with the string “DOC$.” 
For example, the file ROUTINES.SDML would be submitted as the job 
DOC$ROUTINES. 


~ 
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You can use any of the DCL SUBMIT command qualifiers with VAX 
DOCUMENT by using these qualifiers as keywords to the /BATCH 
qualifier. For example, if you want DOCUMENT to be run after 9:00 
and want to be notified when it completes, you could use the following 
command: 


$ DOCUMENT file-spec /BATCH=(AFTER=09:00,NOTIFY) LETTER LNO3 


When you use the /BATCH qualifier, a file is created in your current 
default directory that contains information about the batch job. This file 
has the same file name as the input file, with a default file type of LOG. 
When your batch job completes, this file is printed to the queue defined by 
the logical SYS$PRINT, and the file is deleted. 


You must define any process logical names you enter on the DOCUMENT 
command line in your LOGIN.COM file. Otherwise, VAX DOCUMENT is 
unable to translate the logical name during batch processing and issues an 
error message. 


/CONDITION=condition name 


Specifies a condition keyword for an SDML input file. This qualifier 
accepts a condition name argument that is a text string used to mark 
the condition being set. For more information on using the (CONDITION 
qualifier, see the <SET_CONDITION> tag description and VAX DOCUMENT 
Producing Online and Printed Documentation. 


The /CONDITION qualifier is valid only if tag translation is being done. 
If you specify /NOTAG_TRANSLATOR with the /CONDITION qualifier, 

the /CONDITION qualifier is ignored, and VAX DOCUMENT issues an 

informational message stating that you specified conflicting qualifiers. 


/CONTENTS 


/NOCONTENTS 

Specifies whether a table of contents file is produced. The /NOCONTENTS 
qualifier is the default (except when processing for Bookreader, 

where /CONTENTS is the default) and specifies that no table of 
contents is produced. When you specify the /CONTENTS qualifier, 

VAX DOCUMENT creates a table of contents file with a file name of 
input_filename_CONTENTS. 


If you place the <CONTENTS_FILE> tag in your front matter or profile SDML 
file, the current table of contents file is included at the corresponding point 
in the final printable output file (filename.LN03, filename.PS, and so on). 
If you do not place the <CONTENTS_FILE> tag in your SDML file, the table 
of contents is not incorporated into your final output file, but is placed in 
the separate file, input_filename_CONTENTS, and processed separately. 


For Bookreader output, a table of contents is generated automatically even 
if you do not specify the /CONTENTS qualifier on the command line or use 
the <CONTENTS_FILE> tag in your SDML file. 


If you do not specify /CONTENTS on the DOCUMENT command line 
when you process a file that contains a <CONTENTS_FILE> tag, VAX 
DOCUMENT issues warning messages and the most recent version of 
the table of contents file is included. Note that this may result in an 
outdated table of contents being included in your document. If there is 
no previous table of contents file to be included, you receive a warning 
message and a blank page of output. 
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Device Keyword 
BLANK_PAGES 


Note: 


The /CONTENTS qualifier is valid only if text formatting is being done. 
If you specify /NOTEXT_FORMATTER with the /CONTENTS qualifier, 
VAX DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 


Note that if you process your document with the /NOTAG_TRANSLATOR 
and /CONTENTS qualifiers, and the table of contents is included using 
the <CONTENTS_FILE> tag, the table of contents is incorporated into 

your document, placed in the file filename_CONTENTS, and processed 
separately. 


The maximum length of a VMS file name is 39 characters. If you 
want to generate a contents file, your input file name must have 
no more than 30 characters, because appending CONTENTS to it 
adds 9 more characters. 


For more information on generating a table of contents, see VAX 
DOCUMENT Producing Online and Printed Documentation and the 
<CONTENTS_FILE> tag description. 


/DEVICE_CONVERTER[=(device keyword [,device 
keyword...])] 


/NODEVICE_CONVERTER 


Specifies whether the device converter is run. Using /NODEVICE_ 
CONVERTER excludes device conversion. 


The device converter reads and processes an intermediate file (with the 
file type .DVI_device) and converts it to a file suitable for output on the 
destination device. The output from the device converter has the same file 
name as the input file you specified on the command line, and a file type 
based on the destination keyword you specified on the command line. 


The /DEVICE_CONVERTER qualifier optionally accepts the following 
keywords for special processing of your file: 


Description 


Specifies that the PostScript device converter insert blank pages 
where needed in the PostScriet output to create a two-sided 
document for printing on a duplex printer or for copying on a 
two-sided copier. 


HORIZONTAL_OFFSET=number of points Specifies where the text is to be positioned, relative to the left edge 
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of the paper. The default horizontal offset for the page is one inch 
(72 points). 

The number of points argument specifies the number of points the 
text page should be moved to the right from the left edge of the 
paper. This argument must be zero or a positive integer. The left 
edge of the paper is assumed to be zero. 


Device Keyword 


VERTICAL_OFFSET=number of points 


STARTING_PAGE=folio spec 


ENDING_PAGE=/folio spec 


NUMBER_OF_PAGES=maximum pages 


DOCUMENT[/FORMATTER] 


Description 


Specifies where the text is to be positioned, relative to the top edge 
of the paper. The default vertical offset for the page is one inch (72 
points). 

The number of points argument specifies the number of points 

the text page should be moved toward the page bottom from the 
top edge of the page. This argument must be zero or a positive 
integer. The top edge of the paper is assumed to be zero. 


Specifies the beginning page number of the first page in a range of 
pages to be printed. If you do not specify an ending page, the rest 
of the file is printed. The folio spec value can be any valid page 
number that VAX DOCUMENT produces on the page. 


Specifies the ending page number of the last page in a range of 
pages to be printed. The folio spec value can be any valid page 
number that VAX DOCUMENT produces on the page. If both the 
ENDING_PAGE and NUMBER_OF_PAGES keywords are used 
together on the same command line, VAX DOCUMENT issues an 
error message. 


Specifies the number of pages to print when you do not specify 
the ENDING_PAGE keyword. If both the ENDING_PAGE and 
NUMBER_OF_PAGES keywords are used together on the same 
command line, VAX DOCUMENT issues an error message. 


The maximum pages value must be an integer specifying the total 
number of pages to print. If this number is specified as a number 
larger than the number of pages in the document (for example, 
99999), all pages of the document are printed. 


Use the STARTING_PAGE and ENDING_PAGE keywords to specify the 
page numbers that are to be processed. Each of these keywords accepts a 
folio spec argument. A folio spec has the following syntax: 


[{folio prefix}{separator}] {page number} 


The following list describes the rules for each of the folio spec syntax 


elements: 


¢ folio prefix 


Specifies the numbers or letters that prefix the folio spec. A folio prefix 
can be any of the following: 


— Any single letter. Specifies an appendix in your document, for 
example, the letter “B” in the folio spec B-6. 


— Any number. Specifies a chapter number, for example, the number 
“13” in the folio spec 13-1. 


— The keywords GLOSSARY or INDEX. Specifies a page in the 
glossary or index, for example, “INDEX” in the folio spec INDEX-—6. 


— The keyword PARTn where n is an integer of one or greater. 
Specifies a section begun using a <PART_PAGE> tag, for example, 
“PART2” in the folio spec PART2—7. 


— An asterisk (*). Specifies the first section of your document. 
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¢ separator 


Specifies the character that separates the folio prefix from the page 
number. The separator can be any single character that is not a space, 
a number, or a letter. In the folio spec 11-3, “—” is the folio prefix. You 
cannot use a separator if you do not specify a folio prefix. 


¢ page number 


Specifies the page number portion of a folio spec. In the folio spec 
11-3, “3” is the page number. The page number can be a Roman 
number, an Arabic number, or an asterisk (*). Roman numbers 
specify a page in the preface of a document, Arabic numbers specify 
pages outside the preface section, and the asterisk (*) specifies the 
first page of the document section specified by the folio prefix. 


The following DOCUMENT command specifies that pages 11-3 through 
11-8 of file MYREPORT.DVI_LNO3 be processed by the device converter. 


$ DOCUMENT/NOTAG TRANSLATOR/NOTEXT_FORMATTER myreport.DVI_LNO3 - 
_$ REPORT LNO3/DEVICE= (STARTING=11-3,ENDING=11-8) 


/DIAGNOSTICS[=file spec] 
/NODIAGNOSTICS 


Causes the tag translator to write VAX Language-Sensitive Editor (LSE) 
diagnostics records to a file. LSE uses these records during its REVIEW 
phase to locate and describe translation errors. The default qualifier is 
/NODIAGNOSTICS. See VAX DOCUMENT Producing Online and Printed 
Documentation for more information on LSE. 


If you omit the file specification, the output file has the same name as the 
input file, with a file type of DIA. 


The /DIAGNOSTICS qualifier is valid only if tag translation is being done. 
If you specify /NOTAG_TRANSLATOR with the /DIAGNOSTICS qualifier, 
VAX DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 


/ELEMENT=file spec 


Names the book element that includes the input file specified on the 
command line. When you use the /ELEMENT qualifier to process a 
subelement of a book, you must also use the /PROFILE qualifier to specify 
the profile for the book that contains the book element. If you do not 
specify the file type of the element file, the default file type is SDML. 

For more information on processing a subelement of a book, see VAX 
DOCUMENT Producing Online and Printed Documentation. 


The /ELEMENT qualifier is valid only if tag translation is being done. 

If you specify /NOTAG_TRANSLATOR with the /ELEMENT qualifier, 
VAX DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 


/INCLUDE=file spec 

Specifies a VAX DOCUMENT file that you want to be included before the 
input file you specified on the command line. If you do not specify the 
file type of the file to be included, SDML is the default file type. You can 
use the /INCLUDE qualifier on the command line only once. For more 
information about using the \INCLUDE qualifier, see VAX DOCUMENT 
Producing Online and Printed Documentation. 


Note: 
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The /AANCLUDE qualifier is valid only if tag translation is being done. If 
you specify /NOTAG_TRANSLATOR with the INCLUDE qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 


AINDEX[=(index keyword [,index keyword...])] 


/NOINDEX 

Specifies whether an index file is produced. The /NOINDEX qualifier is 
the default and specifies that no index is produced. When you specify the 
/INDEX qualifier, VAX DOCUMENT creates an index file with a file name 
of input_filename_INDEX. 


When you place the <INDEX_FILE> tag in your profile file, the current 
index file is included at the corresponding point in the final printable 


output file (filename.LNO3, filename.PS, and so on). If you do not place the 


<INDEX_FILE> tag in your profile file, the index is not incorporated into your 
final output file, but is placed in the file input_filename_INDEX, which is 
printable separately. 


If you do not specify /INDEX on the command line when you process a file 
that contains an <INDEX_FILE> tag, VAX DOCUMENT issues a warning 
message and the most recent version of the index file that already existed 
is included in your document. This may be an outdated index. If no 
previous index file exists, the device converter issues a warning message. 


The /INDEX qualifier is valid only if text formatting is being done. If 
you specify /NOTEXT_FORMATTER with the /INDEX qualifier, VAX 

DOCUMENT issues a warning message stating that you specified an 

illegal combination of command elements. 


Note that if you process your document with the /NOTAG_TRANSLATOR 
and /INDEX qualifiers, and the index is included using the <INDEX_FILE> 
tag, the index is incorporated into your document, placed in the file 
filename_INDEX, and processed separately. 


The maximum length of a VMS file name is 39 characters. If you 
want to generate an index file, your input file name must have no 
more than 33 characters, because appending _INDEX to it adds 6 
more characters. 

The following list describes the optional indexing keywords that you can 
use with the /INDEX qualifier. For more information on creating and 
generating a single-document and a master index, see the <X>, <XS>, and 
<Y> tag descriptions. 
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Index Keyword 


{ GUIDE_HEADINGS } 
NOGUIDE_HEADINGS 


son { EE 


NONALPHA=AFTER 
[, <« NONALPHA=BEFORE } ]) 
NONALPHA=IGNORE 


{ OVERRIDE_MASTER } 
NOOVERRIDE_MASTER 


Description 


Specifies whether alphabetic headings are created for each letter 
group in the index. (The entries beginning with “A” have an A 
at the start of the group, and so on.) The GUIDE_HEADINGS 
keyword is the default. The NOGUIDE_HEADINGS keyword 
suppresses guide headings in the index output file. 


Specifies the sorting method used to order entries in an index. 


* SORT=LETTER sorts the entry letter by letter and ignores 
spaces and hyphens. SORT=LETTER is the default. 

¢ SORT=WORD sorts the entry letter by letter and treats 
spaces and hyphens as significant. 

¢ SORT=NONALPHA positions an entry with leading 
nonalphabetic characters in the index based on the keyword 
supplied with the NONALPHA keyword. 

— The AFTER keyword causes an entry with leading 
nonalphabetic characters to be placed at the end of the 
index. 

— The BEFORE keyword causes an eniry with leading 
nonalphabetic characters to be placed at the beginning 
of the index. 

— The IGNORE keyword causes an entry with leading 
nonalphabetic characters to be sorted by the first 
alphabetic characters in the entry. The default is 
NONALPHA=IGNORE. 


Specifies the inclusion of index entries in both single-document 
indexes and master indexes; NOOVERRIDE_MASTER is 

the default keyword for both /INDEX and /MASTER_INDEX. 
OVERRIDE_MASTER and NOOVERRIDE_MASTER have no 
effect for Bookreader output. 


* Use /INDEX=NOOVERRIDE_MASTER to create a single- 
document index that contains only the index entries that are 
not marked with the MASTER keyword; this is the default. 

« Use /INDEX=OVERRIDE_MASTER to create a single- 
document index that contains both the index entries that are 
not marked with the MASTER keyword and the entries that 
are marked with the MASTER keyword. 

¢ Use /MASTER_INDEX=NOOVERRIDE_MASTER to create 
a master index that contains only the index entries that are 
marked with the MASTER keyword; this is the default. 

« Use /MASTER_INDEX=OVERRIDE_MASTER to create a 
master index that contains both the index entries that are not 
marked with the MASTER keyword and those entries that are 
marked with the MASTER keyword. 





/KEEP[=(filetype keyword [, filetype keyword...] )] 


/NOKEEP 


Specifies whether all intermediate files are kept or deleted. The default 
qualifier /NOKEEP indicates that the intermediate files are deleted by 
VAX DOCUMENT after processing. 
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You can use the following keywords to specify individual intermediate files 
that are to be kept: 


File Type 

Keyword File Contents 

DVI Specifies an intermediate output file from the text formatter. You may 
want to keep this file for reprocessing at a later date, or to process 
and print only certain pages. 
The actual file type is based on the destination you specified on the 
DOCUMENT command line. These file types and the destination 
keywords that create them are listed under the description of the 
/TEXT_FORMATTER qualifier. 

INX Specifies an ASCII file that contains index entries in page-number 
order. You can use this file to create a master index. 

TEX Specifies an input file for the text formatter. Note that a TEX 
file processed with a certain doctype can produce errors if it is 
reprocessed with a different doctype. 

/LIST[=file-name] 

/NOLIST 


Specifies whether a listing file is produced. The /NOLIST qualifier is the 
default and suppresses the generation of a listing file. If you do not specify 
a file specification as an argument to the /LIST qualifier, a listing file is 
produced with the file name of the input file specification and a default 
file type of LIS. If you specify a file specification as an argument, that file 
specification is used as the output file. 


The listing file contains the following information: 
e All messages generated by the tag translator 

e All messages generated by the text processor 

e All messages generated by the device converter 


e A brief summary section. This summary includes the following 
information: 


— The original command line 

— The time and day that processing began 

— The total CPU time used 
If you are running DOCUMENT as a batch job and want a complete log 
file (including output from your LOGIN.COM, symbol definitions, and so 
on), you should use the /LOG qualifier instead of the /LIST qualifier. Do 
not use /LOG, however, if you are using the symbol generator. 
/LOG 
/NOLOG 


Specifies whether informational messages are issued during processing. 
The /LOG qualifier is the default and specifies that informational messages 
are issued. The /NOLOG qualifier suppresses informational messages. 
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The following example shows the typical informational messages displayed 
during tag translation: 


$ DOCUMENT myarticle ARTICLE LNO3 

SDOC-I-IDENT, VAX DOCUMENT V2.0 

[Tag Translation]... 
$TAG-I-DEFSLOADD, End of Loading of Tag Definitions 
STAG-I-ENDPASS 1, End of first pass over the input 
[Text Formatting]... 


If you are running DOCUMENT as a batch job and do not need a complete 
log file (including output from your LOGIN.COM, symbol definitions, and 
so on), you can use the /LIST qualifier instead of the /LOG qualifier. 


/MAP[=tfile spec] 


/NOMAP 

Specifies whether all the input files processed by VAX DOCUMENT are 
listed in a file. This file starts with the SDML input file and includes the 
tag table and any SDML files specified by the INCLUDE or /SYMBOLS 
qualifier or the <ELEMENT> or <INCLUDE> tags. Files that are included by 
other files are indented under those files in this listing. The default file 
type is MAP_LIS. The default qualifier is /NOMAP. 


The /MAP qualifier is valid only if tag translation is being done. If 
you specify /NOTAG_TRANSLATOR with the /MAP qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 


/MASTER_INDEX[=(index keyword [,index 
keyword...])] 
/NOMASTER_INDEX 


Causes indexing files to be collated into a master index file. 


When you specify the /(MASTER_INDEX qualifier, VAX DOCUMENT 
expects a master index data file as the input file. This data file lists the 
index output (INX) files generated from the individual books that are being 
referenced in the master index. The default file type of this input file is 
INX_LIST. 


This qualifier accepts the same optional indexing keywords as the [INDEX 
qualifier. See the description of the /INDEX qualifier for a list of these 
keywords and their uses. 


This qualifier has no effect for Bookreader output. For more information 
on generating a master index, see VAX DOCUMENT Producing Online 
and Printed Documentation. 


/OUTPUT=file spec 

Specifies a new name for the output file. If you do not use the /OUTPUT 
qualifier, the output file is given the same file name as the input file, but 
with a file type based on the other qualifiers and destination chosen. 


An example of a command line that uses the /OUTPUT qualifier follows: 
$ DOC somefile LETTER LNO3 /NOTEXT_FORMATTER /OUTPUT=anotherfile 


This command line creates the file ANOTHERFILE.TEX, because 
processing was completed before the text formatter was run. If you omit 
/NOTEXT_FORMATTER from the preceding command line, the output file 
is ANOTHERFILE.LNO3. 


DOCUMENT[/FORMATTER] 


The following table lists the output file types and the default destination 
keywords that produce them. 


Default Destination Keyword Default File Type 


BOOKREADER DECW$BOOK 
HELP HLP 

LINE | LINE 

LNO3 LNO3 

MAIL TXT 

PS PS 
TERMINAL TERM 


/PRINT[=(qualifier keyword [, qualifier keyword...])] 


/NOPRINT 
Specifies whether the output file is printed. /NOPRINT is the default. 


You can use any of the DCL PRINT command qualifiers as keywords to 
the /PRINT qualifier. For example, if you want to print two copies of a 
VAX DOCUMENT file with no flag page, you can use the PRINT command 
as follows: 


S$ PRINT/NOFLAG/COPIES=2 somefile.line 


You can specify the same options using the following /PRINT qualifier on 
the DOCUMENT command line: 


$ DOC/NOTAG/NOTEXT/NODEV somefile - 
_$/PRINT=(NOFLAG, COPIES=2) LETTER LINE 


You can double-space your output, but only for monospaced destinations: 
LINE, MAIL, and TERMINAL. For example, the following command 
produces double-spaced MAIL output: 


$ DOCU somefile.mail MAIL MAIL/PRINT=SPACE 


You can enter multiple arguments to the /PRINT qualifier keyword on the 
DOCUMENT command line by enclosing the arguments in three pairs of 
quotation marks. For example: 


$ DOCU somefile.sdml SOFT.REF PS - 
$\PRINT= (NOTIFY, PARAMETER="""(MESSAGE=PRINT, - 


_SDATA=POSTSCRIPT)""", QUEUE=PS_PRINT) 


Default print queues for each of the destination keywords available at your 
site are established when VAX DOCUMENT is installed. These queues 
include all DCL PRINT command qualifiers needed for correct printing on 
that output device. 


If you choose to specify a print queue other than SYS$PRINT, the default, 
you must also specify the correct qualifier keywords needed for that 
queue. These keywords vary depending on the type of file you want to 
print (indicated by the file extension) and the type of output device. The 
following table shows the keywords to use for each file and output device 
combination. 
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Output 
File Type 


LINE 


LNOS3 


PS 


Output 
File Type 


LINE 


LNO3 


PS 
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Print 
Device 


Line Printer 
LNO3 Laser Printer 
LNO3 PLUS Laser Printer 


LNO3R ScriptPrRinTerR 
PrintSeRver 40 


LNO3 Laser Printer 
LNOS3 PLUS Laser Printer 


LNO3R ScriptPrinter 
PrintServer 40 


LNOSR ScriptPrinterR 
PRINTSERVER 40 


DOCUMENT /PRINT Qualifier-Keywords 
/PRINT=(QUEUE=queuename) 


/PRINT=(QUEUE=queuename) 


/PRINT=(QUEUE=queuename) 


/PRINT=(QUEUE=queuename) 


/PRINT=(QUEUE=queuename) 


If you want to print your file using the DCL PRINT command, the 
following table shows the qualifiers you must use for each supported 


device. 


Print 
Device 


Line Printer 
LNO3 Laser Printer 
LNO3 PLUS Laser Printer 


LNO3R ScrieptPrinterR 
PrRINTSERVER 40 


LNO3 Laser Printer 
LNO3 PLUS Laser Printer 


LNOS3R ScriptPRinterR 
PrintServer 40 


LNOSR ScriptPrRiInTER 
PrintServer 40 


DCL PRINT Command Qualifiers 


$ PRINT filename.LINE 
_$ /QUEUE=queuename 


$ PRINT/PARAM=(DATA_TYPE=ANSI)) filename.LINE 
_$ /QUEUE=queuename 


$ PRINT/NOFEED/PASSALL filename.LN03 
_$ /QUEUE=queuename 


$ PRINT/PARAM=(DATA_TYPE=ANS)) filename.LN0O3 
_$ /QUEUE=queuename 


$ PRINT/PARAM=(DATA_TYPE=POST) filename.PS 
_$ /QUEUE=queuename 


Note that if any serious errors are encountered during processing, the file 
is not sent to the print device. 


/PROFILE=file spec 

Specifies that the input file is a book element and that a cross-reference 
data file previously created by a VAX DOCUMENT bookbuild be used to 
resolve any cross references in the input file. Specify the cross-reference 
data file as an argument to the /PROFILE qualifier; it has a file type of 
XREF. For more information on using the /PROFILE qualifier, see VAX 
DOCUMENT Producing Online and Printed Documentation. 


The /PROFILE qualifier is valid only if tag translation is being done. If 
you specify /NOTAG_TRANSLATOR with the /PROFILE qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 


) 


DOCUMENT[/FORMATTER] 


/SYMBOLSs=tTile spec 
/NOSYMBOLS 


Controls whether a file of symbol definitions is read automatically during 
tag translation. The default qualifier is /NOSYMBOLS. The SDML input 
file accessed through the /SYMBOLS qualifier should contain only symbol 
definitions created by the <DEFINE_SYMBOL> and the <DEFINE_BOOK_NAME> 
tags. You can use the /SYMBOLS qualifier on the command line only 
once. For more information on using the /SYMBOLS qualifier, see VAX 
DOCUMENT Producing Online and Printed Documentation. 


The /SYMBOLS qualifier is valid only if tag translation is being done. If 
you specify /NOTAG_TRANSLATOR with the /SYMBOLS qualifier, VAX 
DOCUMENT issues a warning message stating that you specified an 
illegal combination of command elements. 


/TAG_TRANSLATOR 
/NOTAG_TRANSLATOR 


Controls whether the tag translator is run. If you do not specify this 
qualifier, the default qualifier is /TAG_TRANSLATOR. 


By default, the tag translator produces an output file with the file name 
of the input file and a file type of TEX. You can then use this file as an 
input file to the text formatter. Using /NOTAG_TRANSLATOR excludes 
tag translation and the following related qualifiers: /CONDITION, 
/ELEMENT, /DIAGNOSTICS, /INCLUDE, /MAP, /PROFILE, and 
/SYMBOLS. For more information on using the /TAG_TRANSLATOR 
qualifier, see VAX DOCUMENT Producing Online and Printed 
Documentation. 


/TEXT_FORMATTER 
/NOTEXT_FORMATTER 


Controls whether the text formatting program is run. If you specify 
/NOTEXT_FORMATTER, VAX DOCUMENT processing stops after the 
tag translator completes, and text formatting and the following related 
qualifiers are excluded: /CONTENTS and /INDEX. /TEXT_FORMATTER 
is the default. 


If you specify /NOTAG_TRANSLATOR and the input file you specify on 
the command line does not include a file type, the default file type is TEX. 
The output file from the text formatter can have one of several file types 
based on the destination entered on the command line. These default 
output file types and their related destination keywords are given in the 
following list. 


Destination Intermediate Final 

Keyword Output File Type Output File Type 
BOOKREADER DVI_BOOKREADER DECW$BOOK 
HELP None. HLP 

LINE DVI_LINE LINE 

LNO3 DVI_LNO3 LNO3 

MAIL DVI_LINE TXT 
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Destination Intermediate Final 

Keyword Output File Type Output File Typ 
PS DVI_PS PS 

TERMINAL DVI_LLINE TERM 





You can then use the output file from the text formatter as an input file to 
the device converter. 





EXAMPLE When you process your input file using the DOCUMENT command, you 
are actually running your file through several processors. The following 


example shows a typical use of the VAX DOCUMENT command: 


$ DOCUMENT myreport.SDML REPORT LNO3 /CONTENTS 


SDOC-I-IDENT, VAX DOCUMENT V2.0 
[Tag Translation)... 
STAG-I-DEFSLOADD, End of Loading of Tag Definitions 
STAG~I~ENDPASS 1, End of first pass over the input 
(Text Formatting]... 
$TEX-I-PAGESOUT, 17 pages written. 
-TEX-I-OUTFILENAME, ’DUA1: [DOCFILES]MYREPORT.DVI_LNO3’ 
{Contents Generation]... 
{Text Formatting Contents]... 
%STEX-I-PAGESOUT, 1 page written. 
~TEX-I-OUTFILENAME, ‘’DUA1: [DOCFILES]MYREPORT_CONTENTS.DVI_LNO3’ 
{Device Conversion)... 
SDVC-I-PAGESOUT, 18 pages written to file: 
DUA1: [DOCFILES]MYREPORT.LNO3 
{Contents Device CO: n Ver S* 1.0 Te Joes 
SDVC-I-PAGESOUT, 1 page written to file: 
DUAL: [DOCFILES]MYREPORT_CONTENTS.LNO3 
[Printing File]... 
Job MYREPORT (queue SYSSLNO3, entry 833) started on SYSSLNO3 


[Printing Content sj... 
Job MYREPORT CONTENTS (queue SYS$LNO3, entry 834) started on SYS$LN03 
$ 
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DOCUMENT/GENERATE SYMBOL 


Starts the VAX DOCUMENT symbol generator. 








FORMAT DOCUMENT/GENERATE_SYMBOL//L/ST/=file-name]] 
[/PREFIX= 
prefix-name] 
input-file 

Command Qualifier Default 

/LIST[=file-name] /NOLIST 

/PREF|X=prefix-name Up to 25 characters of the input-file. 
restrictions The /GENERATE_SYMBOL conuand must immediately follow the 

DOCUMENT command. 


PARAMETERS _input-file | 
Specifies: the input file to be processed. You cannot use wildcards in the 
input file specification. 


The default file type of the input file is SDML. 





DESCRIPTION DOCUMENT/GENERATE_SYMBOL is the command you specify to start 
the symbol generator. It requires one parameter: 


¢ Input File 


Specifies the input file for the symbol generator. By default, this file is 
an SDML file containing SDML tags. 


The symbol name that is created consists of a prefix that you supply, with 
an appended sequential number that VAX DOCUMENT generates. VAX 
DOCUMENT creates a new version of the SDML file with symbol names 
added to tags that did not already have symbol names. The original SDML 
file is not deleted. 

You can use the symbol generator on your profile file. You can also use the 
symbol generator on SDML files that use the <INCLUDE> tag; the symbol 
generator adds symbols to any file that VAX DOCUMENT includes with 
the <INCLUDE> tag. 


For information on how to use the symbol generator, see VAX DOCUMENT 
Producing Online and Prinied Documentation. 


DOCUMENT/GENERATE_SYMBOL 


QUALIFIERS 
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/LIST[=file name] 


/NOLIST 

Specifies whether a listing file is produced. The /NOLIST qualifier is the 
default and suppresses the generation of a listing file. If you do not specify 
a file specification as an argument to the /LIST qualifier, a listing file is 
produced with the file name of the input file specification and a default 
file type of LIS. If you specify a file specification as an argument, that file 
specification is used as the output file. 


The listing file contains the following information: 
e All messages generated by the tag translator 


¢ <A brief summary section. This summary includes the following 
information: 


— Original command line 
— Time and day that processing began 
— Total CPU time used 


/PREFIX=prefix-name 


Specifies the prefix you want appended to each symbol name in your file, 
including any included files. If you do not specify a prefix-name, a default 
prefix of up to 25 characters of the input-file name is used. If the input-file 
exceeds a length of 25 characters, the remaining characters are truncated. 
Any alphanumeric character is valid. Invalid characters are changed to 
underscores only when the default prefix is used. 


For example, you could use the following command: 


$ DOCUMENT/GENERATE_SYMBOL/LIST/PREFIX=ABC MYFILE.SDML 


B 


Messages 


A message has the following format: 
% facility--severity--identification, text 


Messages in VAX DOCUMENT can come from the following facilities: 


Facility code _— Facility 


DOC The DOCUMENT command line 
TAG The tag translator 

TEX The text processor 

DVC The device converter 

INX The index facility 


The messages from these sources are given in the following sections. 


To locate a message, use the facility code to locate the appropriate section 
and then look for the identification text in that section. Messages are 
alphabetical within sections. 


For example, consider the following message: 


$TAG-W-ISTHISTAG, at text on line 245 in file 
WRT_: [YOURNAME . BOOK] INTRO. SDML; 
Ignoring <list. Is this a tag without a closing angle bracket? 


The facility code in this error is TAG, so you look in the section for tag 
translator message. The identification text is ISTHISTAG, so you locate 
that within the section. 


Messages 
DOCUMENT Command Messages 





B.1 DOCUMENT Command Messages 
ACTION_EXCL, qualifier is not available for the chosen destination 


Warning: Indicates that the default qualifier has been excluded for the 
desired destination and will therefore be ignored. 


User Action: None. 


AMB_DESIGN, Ambiguous design keyword design-keyword 
Fatal: An ambiguous design keyword was specified. 


User Action: Change the specified design keyword to be a unique design 
keyword. 


AMB_DEST, Ambiguous destination keyword destination-keyword 
Fatal: An ambiguous destination keyword was specified. 


User Action: Change the specified destination keyword to be a unique 
keyword. 


AMB_PAPER_SIZE, Ambiguous paper size value 
Error: The specified paper size value is ambiguous. 


User Action: Specify a unique paper value and reexecute the 
DOCUMENT command. 


CANT_GET_VALUE, Cannot get value of /qualifier qualifier 
Fatal: A required value associated with the qualifier was not provided. 


User Action: Specify a value for the qualifier and reexecute the 
DOCUMENT command. 


CANT_OPEN, Error detected opening file file-spec 
Error: An error has occurred while opening the specified file. 


User Action: Correct the error if you can or refer the problem to your 
system manager. After fixing the problem, reexecute the DOCUMENT 
command. 


CANT_USE_SHR, Cannot use file-spec 


Fatal: A shareable image file for text processing could not be found or 
used. 


User Action: Consult your system manager. 


DCL_ERROR, An error was detected while parsing 
\DCL-command\ 


Error: An error was detected by the DCL parser. 


User Action: Correct the error on the specified line and reexecute the 
DOCUMENT command. 
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DESIGN_ERROR, Bad design entry in design-file-directory DOC$DESIGNS 
data file 


Error: An error was found in a design data file; erroneous design entries 
are ignored. 


User Action: Correct the error and reexecute the DOCUMENT command.. 


DESIGN_SYNTAX, Ignoring design-keyword design entry 
Error: A syntax error is detected in the design data file. 
User Action: Correct the error and reexecute the DOCUMENT command. 


DEST_ERROR, Bad destination entry in destination-file-directory 
DOC$DESTINATIONS data file 


Error: An error was found in a destination data file. Any involved entries 
are ignored. 


User Action: Correct the error and reexecute the DOCUMENT command. 


DEST_SYNTAX, Ignoring destination-keyword destination data entry 
Error: An error has been detected in a destination data file. 


User Action: Correct the errors in the destination data file and reexecute 
the DOCUMENT command. 


DO_CONTENTS, [ContentsGeneration ]... 
Informational: Indicates that a contents file is being created. 


User Action: None. 


DO_DEVICE, [DeviceConversion ]... 


Informational: Indicates that the document input is being processed into 
a printable form. 


User Action: None. 


DO_DVC_CONTENTS, [ContentsDeviceConversion ]... 


Informational: Indicates that the document contents is being processed 
into a printable form. 


User Action: None. 


DO_DVC_INDEX, [IndexDeviceConversion ]... 


Informational: Indicates that the document index is being processed into 
a printable form. 


User Action: None. 


DO_INDEX, [IndexGeneration ]... 
Informational: Indicates that an index file is being created. 


User Action: None. 
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DO_MASTER_INDEX, [MasterIndexGeneration]... 
Informational: Indicates that a master index file is being created. 


User Action: None. 


DO_PRINT, [PrintingFile ]... 


Informational: Indicates that your output file is being sent to the 
designated print queue. 


User Action: None. 


DO_TAG, [TagTranslation]... 


Informational: Indicates that the tag translator is processing your SDML 
input file. 


oad 


User Action: None. 


DO_TEXT, [TextFormatting ]... 
Informational: Indicates that the text formatter is processing. 


User Action: None. 


DO_TEXT_CONTENTS, [TextFormattingContents ]... 


Informational: Indicates that the text formatter is processing the 
contents file. 


User Action: None. 


DO_TEXT_INDEX, [TextFormattingIndex ]... 


Informational: Indicates that the text formatter is processing the index 
file. 


User Action: None. 


ERROR_CONVERTER, Errors found by the device converter 


Error: The device converter has ended in error; processing cannot 
continue. 


User Action: Correct the errors found by the device converter and 
reexecute the DOCUMENT command. 


ERROR_FORMATTER, Errors found by the text formatter 
Error: The text formatter has ended in error; processing cannot continue. 


User Action: Correct the errors found by the text formatter and reexecute 
the DOCUMENT command. 


ERROR_INDEXER, Errors found by the indexing facility 


Error: The indexing facility has ended in error; processing cannot 
continue. . 


User Action: Correct the errors found by the indexing facility and 
reexecute the DOCUMENT command. 
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ERROR_IN_DESIGN, Internal design date file error 
Fatal: An unspecified error in the design data file was found. 


User Action: Refer the problem to your system manager. If you receive 
this message and are under a service contract with Digital, call your 
customer service center. Otherwise, submit a Software Performance 
Report. 


ERROR_IN_DEST, Internal destination data file error 
Fatal: An unspecified error in the destination data file was found. 


User Action: Refer the problem to your system manager. If you receive | 
this message and are under a service contract with Digital, call your 
customer service center. Otherwise, submit a Software Performance 
Report. 


ERROR_TAG, Errors found by the tag translator 
Error: The tag translator has ended in error; processing cannot continue. 


User Action: Correct the errors found by the tag translator and reexecute 
the DOCUMENT command. 


ERROR_WRITE, Error writing to file file-spec 


Fatal: An RMS error was reported when DOCUMENT tried to read the 
specified file. 


User Action: Correct the RMS error and reexecute DOCUMENT 
command. 


ERR_CRE8_LIST, Listing file file-spec cannot be created 
Fatal: The specified listing file could not be created. 


User Action: Correct the error in the listing file specification. 


FILLM_TOO_LOW, Process open file limit too low, required value is 
minimum-value 


Fatal: The FILLM of the current process in not large enough to run the 
DOCUMENT command. 


User Action: Contact you system manager to increase the quota. 


IDENT, VAX DOCUMENT version number 
Informational: DOCUMENT version number identification message. 


User Action: None. 


IGNOR_DESIGN, Ignoring optional logical-name design data file 


Informational: Optional DOC$LOCAL_FORMATS or DOC$STANDARD._ 
FORMATS design file cannot be opened. Any designs that are in that file 
will be unavailable. 


User Action: Correct the problem and reexecute the DOCUMENT 
command or contact your system manager. , 
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INVALID_DESIGN, design-keyword is not a valid design 


Fatal: An unrecognized design parameter was specified on the 
DOCUMENT command line. 


User Action: Specify a valid design parameter and reexecute the 
DOCUMENT command. 
INVALID_DEST, destination-keyword is not a valid destination 


Fatal: An unrecognized destination keyword was specified on the 
DOCUMENT command line. 


User Action: Specify a valid destination keyword and reexecute the 
DOCUMENT command. 
INVALID_DVI_ARG, qualifier-arg is not a valid /DEVICE_CONVERTER 
argument 


Fatal: The argument value specified to /DEVICE_CONVERTER is 
unrecognized. 


User Action: Specify a valid qualifier argument and reexecute the 
DOCUMENT command. 


INVALID_ENTRY, qualifier-entry is not a valid /qualifier entry 


Fatal: An invalid qualifier entry was specified on the DOCUMENT 
command. 


User Action: Specify a valid qualifier and reexecute the DOCUMENT 
command. Refer to Appendix A in this manual for information about valid 
DOCUMENT command qualifiers. 


INVALID_INPUT, Cannot use file-spec as an input file 
Fatal: The specified input file is invalid. 


User Action: Specify a valid input file specification and reexecute the 
DOCUMENT command. 


INVALID_VALUE, Cannot use file-spec as a file for /qualifier 


Fatal: The specified input file associated with the qualifier cannot be 
opened. 


User Action: Specify a valid input file specification and reexecute the 
DOCUMENT command. 


NEED_VALUE, Destination entry parameter command needs /VALUE or a 
keyword 


Error: Syntax error found when parsing the destination data file. 


User Action: Refer the problem to your system manager. If you receive 
this message and are under a service contract with Digital, call your 
customer service center. Otherwise, submit a Software Performance 
Report. 
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NOMASTER_DEST, Chosen destination does not allow /MASTER_INDEX 
processing 


Fatal: Master index processing is not allowed for the destination specified 
in the DOCUMENT command. 


User Action: Either remove /MASTER_INDEX from the DOCUMENT 
command or choose another destination, and reexecute the DOCUMENT 
command. 


NO_CONTENTS, No contents; /CONTENTS qualifier unnecessary 


Warning: No contents information was available to generate a contents 
file; no contents file will be produced. 


User Action: Do not use the /CONTENTS qualifier when processing this 
input file. An SDML file must contain at least one <CHAPTER>, <APPENDIX>, 
or <HEADn> tag to produce a table of contents file. 


NO_INDEX, No index; /INDEX qualifier unnecessary 


Warning: No index information was available to generate an index file; 
no index file will be produced. 


User Action: Do not use the INDEX qualifier when processing this input 
file. An SDML file must contain at least one <X> or <Y> tag to produce an 
index file. 


OPEN_DESIGN, Error opening design data file in DOC$STAN DARD_ 
FORMATS 


Fatal: An error occurred when trying to open the DOC$STANDARD_ 
FORMATS:DOC$DESIGNS.DAT data file. 


User Action: Check for the existence of the DOC$STANDARD._ 
FORMATS:DOC$DESIGNS.DAT data file. If it exists, then check the 
file protection on that file. 


OPEN_DEST, Error opening 
DOC$STANDARD_FORMATS:DOC$DESTINATIONS data 
file 


Fatal: There was a RMS error when trying to open the destination data 
file. 


User Action: Check for the existence of the DOC$STANDARD_ 
FORMATS:DOC$DESTINATIONS.DAT data file. If it exists, then check 
the file protection on that file. 


PGFLQ_TOO_LOW, Process paging file quota too low, required value is 
minimum-value 


Fatal: The PGFLQUOTA of the current process is not large enough to run 
the DOCUMENT command. 


User Action: Contact your system manager to increase the quota. 
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PRINT_CONTENTS, [PrintingContents ]... 


Informational: Indicates that your contents file is being sent to the 
designated print queue. 


User Action: None. 


PRINT_INDEX, [PrintingIndex]... 


Informational: Indicates that your index file is being sent to the 
designated print queue. 


User Action: None. 


PROB_CRE_LOGIC, A problem was encountered creating logical name 
logical-name 


Error: An error was returned when VAX DOCUMENT attempted to 
create a VMS process logical name. 


User Action: Correct the error if you can or refer the problem to your 
system manager. After fixing the problem, reexecute the DOCUMENT 
command. 


THESE_DESIGNS, Choose one of these designs: 


Informational: Inquires for choice of document design types, this is 
required input to the DOCUMENT command. 


User Action: At the prompt, type the desired design from the choices 
offered. 


THESE_DESTS, Choose one of these destinations: 


Informational: Inquires for your choice of document destinations. This is 
required input the DOCUMENT command. 


User Action: At the prompt, type the desired destination from the choices 
offered. 


TYPE_INPUT, input file 
Informational: Inquires for the input file. 


User Action: At the prompt, type the name of the input file. 


UNR_DESIGN, Unrecognized design - please check your spelling 


Fatal: An unrecognized design parameter has been specified to the 
DOCUMENT command. 


User Action: Specify a valid design parameter and reexecute the 
DOCUMENT command. 


UNR_DEST, Unrecognized destination - please check your spelling 


Fatal: An unrecognized destination parameter has been specified to the 
DOCUMENT command. 


User Action: Specify a valid destination parameter and reexecute the 
DOCUMENT command. 
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B.2 Tag Translator Messages 


ABORTFORE, at tag or text, line n, file 
file-spec 
There have been more than number error messages of severity 
level E 


Fatal: The tag translator did not produce an output file because it 
detected too many errors in the SDML source file with a severity level of 
Error. SDML defines the minimum number of error messages of severity 
E as 0, although this default value can be modified in local usage. 


User Action: Examine the output from the preceding messages to 
determine the errors you must correct. 


ABORTFORW, at tag or text, line n, file 
file-spec 
There have been more than number error messages of severity 
level W 


Fatal: The tag translator did not produce an output file because it 

_ detected too many errors in the SDML source file with a severity level 
of Warning. SDML defines the minimum number of error messages of 
severity W as 30, although this default value can be modified in local 
usage. 


User Action: Examine the output from the preceding messages to . 
determine the errors you must correct. 


ARGBADOPR, at tag or text, line n, file 
file-spec 
Argument 2 to tag <COUNTER> has an illegal arithmetic 
operator 


Warning: The tag translator has found an illegal operator. The second 
argument to the <COUNTER> tag consists of pairs of operators and 
operands, and an optional trailing comment. 


User Action: If you receive this message and are under a service contract 
a = ee ee with Digital, call your customer service center. Otherwise, submita 
| Software Performance Report. 





! ARGINCMPL, at tag or text, line 7, file 
file-spec 
Argument 2 to tag <COUNTER> is incomplete 


Warning: The tag translator has not found at least one operator and one 
operand. The second argument to the <COUNTER> tag requires at least one 
operator and one operand. 


User Action: If you receive this message and are under a service contract 
4 with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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ARGINVALD, at tag or text, line n, file 
file-spec . 
Argument number to tag <tagname> is an invalid argument. 


Warning: The argument in the specified position is not valid for the 
specified tag. 


User Action: Verify the tag’s argument and correct it. 


ARGMENTIS, The argument is string 


Informational: Follows a message that indicates that an argument 
is invalid, for example, when a numeric argument is required, but a 
character string argument is specified. 


User Action: Use the information to correct your source file. 


ARGMISSNG, at tag or text, line n, file 
file-spec 
Argument number to tag <tagname> is missing 


Warning: The tag translator found no text for the indicated argument, 
but the argument is required for the indicated tag. 


User Action: Supply a value for the indicated argument. 


ARGNOTCHR, at tag or text, line n, file 
file-spec 
Argument to tag <CHR> is not in the range 32 to 126 


Warning: The <CHR> built-in tag requires a numeric argument whose 
value is in the range of 32 to 126. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ARGNOTKEY, at tag or text, line n, file 
file-spec 
Argument number to tag <tagname> is not a keyword 
Warning: The argument in the indicated position is not a valid keyword 
argument for the indicated tag. This message is generally followed by a 
message that shows the keyword that was specified. 


User Action: Using the information in this message and the 
accompanying message, determine the keyword in error. Determine 
the valid arguments for the tag in question and correct your source file. 


ARGNOTLET, at tag or text, line n, file 
file-spec 
_ Argument to tag <SET_APPENDIX_LETTER> is not a letter 


Warning: The <SET_APPENDIX_LETTER> tag requires a letter (A to Z). 


User Action: Correct the source file to supply a letter as the first 
character of the argument. 
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ARGNOTMSG, at tag or text, line n, file 
file-spec 
Argument number to tag <tagname> is not a valid message 
code 


Warning: The indicated argument to the <TAG_DIAGNOSTIC> built-in tag is 
not a recognized message code. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ARGNOTNAM, §at tag or text, line n, file 
file-spec 
Argument number to tag <tagname> is not a valid name 


Warning: The indicated argument does not obey the rules for formation 
of a name. A name must have only letters, digits, and the underscore 
character. A name must not begin with two underscores. Spaces, tabs, 
and carriage returns are not allowed. 


User Action: Correct the argument so that the name is valid. 


ARGNOTNUM, at tag or text, line n, file 
file-spec 
Argument number to tag <tagname> is not a number 


Warning: A non-numeric argument was specified to a tag that requires a 
numeric argument. 


User Action: Verify that the argument is in the correct position in the 
tag’s argument list. Supply a numeric argument to the tag. 


ARGNOTPOS, at tag or text, line n, file 
file-spec 
Argument to tag <tagname> is not a positive integer 


Warning: The <SET_CHAPTER_NUMBER> and <SET_APPENDIX_NUMBER> tags 
require a positive integer for the chapter or appendix number argument. 


User Action: Correct the source file to supply a positive integer. 


ARGNOTQUA, at tag or text, line n, file 
file-spec 
Argument to tag does not begin with a slash 


Error: The argument to the <QUALITEM> tag must be a valid VMS 
qualifier, that is, it must begin with a slash. 


User Action: Correct the source file to supply a slash character. 


ARGNOTVAL, Argument number to tag <tagname> is not an integer from 
1 to6 


Warning: Numeric argument must be an integer from 1 to 6. 


User Action: Supply an integer from 1 to 6. 
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ARGNOTTYP, at tag or text, line 7, file 


file-spec 
Argument string to tag <tagname> is not valid for doctype 
string 


Warning: The indicated argument is not valid for this tag in the indicated 
doctype. 


User Action: Verify that you specified the correct doctype keyword on the 
DOCUMENT command line. 


ARGOUTRAN, at tag or text, line n, file 


file-spec 
Argument number is not in the range 0 to 9 


Warning: The indicated argument cannot be less than 0 or greater 
than 9. 


User Action: Correct the argument so that the number is in range. 


ARGOVRFLW, at tag or text, line n, file 


file-spec 
More than number characters in an argument 


Fatal: The argument is too large. This often indicates that an argument 
list was not terminated correctly. The tag translator may be including 
large portions of the input text as part of the argument. 


User Action: Check the tag indicated by the location information and 
supply the correct terminator to the argument list. 


AUXOVRELW, at tag or text, line n, file 


file-spec . 
More than number auxiliary files open 


Fatal: The number of auxiliary files that can be open simultaneously is 
limited. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADLSTARG, at tag or text, line n, file 


file-spec 
Argument string is not valid for <LIST> type string 


Warning: Verify the argument you specified to the <LIST> tag. Each type 
of list accepts different keyword arguments, for example, UPPERCASE is 
a valid keyword for alphabetic lists, but not for numbered lists. 


User Action: Verify that you have specified the correct type of list. If you 
specify a keyword argument, be sure you spell it correctly. 


Messages 
Tag Translator Messages 


BKSYMNTDF, at tag or text, line n, file 
file-spec 
Symbol string is undefined. 
Bookshelf will not be created. 
Error: A symbol has been referenced but is not in the symbol table. 


User Action: Verify that you spelled the symbol correctly and that the 
same symbol has been entered in the symbol table. 


BNOTESOUT, at tag or text, line n, file 
file-spec 
Accumulated string not referenced. 
Notes will not be output 


Warning: A document contained <BACK_NOTE> or <BIB_NOTE> tags, but no 
corresponding <BACK_NOTES> or <BIB_NOTES> tag was specified to output 
the accumulated notes. 


User Action: Place the <BACK_NOTES> or <BIB_NOTES> tag in the source 
file at the position at which you want them output. 


BOOL2DEEP, at tag or text, line n, file 
file-spec 
Boolean expression has too many nested parentheses. 


Error: A boolean expression is nested too deep. 
User Action: Correct the boolean expression. 
BOOL_BDCH, at tag or text, line n, file 


file-spec 
Bad character in boolean expression: string 


Warning: Each item in a boolean expression must begin with one of the 
characters A(ND), N(OT), OCR), TCRUE), F(ALSE) or must be a left or 
right parenthesis. 


User Action: Correct the boolean expression. 
BOOL_BDST, at tag or text, line n, file 


file-spec 
Bad boolean expression, evaluation incomplete 


Warning: At the completion of the evaluation of the boolean expression, 
some work remained to be done. 


User Action: Correct the boolean expression. 


BOOL_EXPN, at tag or text, line n, file 
file-spec 
Bad boolean expression, string precedes string 


Warning: A boolean expression is improperly formed. The two terms 
shown in the error message cannot appear in the order shown. 


User Action: Correct the boolean expression. 
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BOOL_RTPN, at tag or text, line 7, file 
file-spec 
Unmatched right parenthesis in boolean expression 


Warning: An extra right parenthesis has been found in a boolean 
expression. 


User Action: Correct the boolean expression. 


BOOL_SPEL, at tag or text, line n, file 
file-spec 
Term in boolean expression misspelled 


Warning: One of the words AND, OR, NOT, TRUE, or FALSE is 
misspelled in the boolean expression. 


User Action: Correct the boolean expression. 


BOOL_TKIN, at tag or text, line n, file 
file-spec 
Last word in boolean expression is incomplete 


Warning: The last word in the boolean expression begins with one of the 
characters A, O, N, T, or F, but is not spelled out completely. 


User Action: Correct the boolean expression. 


BOXTOOBIG, at tag or text, line 7, file 
file-spec 
Length number of boxed item exceeds number characters. 


Warning: An argument to the <BOX> tag exceeds the maximum number of 
characters allowed. The text will be output as null. 


User Action: Correct the <BOX> tag to specify an argument with fewer 
characters. 


CALL_NEST, at tag or text, line n, file 
file-spec 
Callouts inaccurately nested in a monospaced example. 


Error: A monospaced example using callouts incorrectly nests 
<EXAMPLE> ... <ENDEXAMPLE> tags (or tags such as <CODE_EXAMPLE> 
that produce monospaced output) with respect to the <CALLOUTS>... 
<ENDCALLOUTS> tags. For example, the following is incorrect: 


<CALLOUTS> (\PREFIX) 
<CODE_EXAMPLE> 


<ENDCALLOUTS> 
<ENDCODE_EXAMPLE> 


User Action: Correct the SDML source file so that the begin and end tags 
for the example and the callouts are correctly nested. For example: 


<CALLOUTS> (\PREFIX) 
<CODE_EXAMPLE> 


<ENDCODE _EXAMPLE> 
<ENDCALLOUTS> 
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CANTOPINT, Cannot open intermediate input file: 
file_spec 


Fatal: The post translator cannot open the INT_TEX file. 


User Action: Verify that the file specification is correct and that you have 
sufficient resources and access rights to open the file. 


CANTOPOUT, Cannot create output file: 
file_spec 


Fatal: The post translator cannot create the TEX file for some reason. 


User Action: Verify that the file specification is correct, and that you 
have sufficient resources and access rights to create the file. 


CASOVRFLW, at tag or text, line n, file 
file-spec 
<CASE> tags have been nested beyond the limit of number 


Fatal: The <CASE> built-in tag has been nested beyond the allowed limit. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


COMNOTEND, at tag or text, line n, file 
file-spec 
A <COMMENT> in a tag definition has not been terminated 
Error: A tag’s definition contains a comment that is not properly 
terminated. 


User Action: Examine the tag definition to be certain that the 
comment text is terminated. If the comment text contains characters 
such as ampersand, backslash, vertical bar, or parentheses, use the 
<COMMENT> . .. <ENDCOMMENT> format. 


CPU_USAGE, Pass 1: number Pass 2: number Total: number seconds 


Informational: The tag translator reports its CPU usage during pass 1 
and pass 2 and the total for both passes. . 


User Action: None. 
CPYNAMHID, at tag or text, line n, file 


file-spec 
<COPY_TAG> is referencing a tag (<tagname>) that is hidden 


Warning: The name referenced by the <COPY_TAG> is hidden, and 
therefore cannot be copied as a new tag definition. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. . 
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CPYNAMUND, at tag or text, line n, file 


file-spec 
<COPY_TAG> is referencing a name (string) that is undefined 


Warning: The name referenced by the <COPY_TAG> is not defined, and 
therefore cannot be copied as a new tag definition. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


DEFSLOADD, End of Loading of Tag Definitions 


Informational: This message is issued after the tag definitions have been 
loaded and before the reading of any input files. If any error messages 
appear before this message, the errors were detected during the loading of 
the tag definitions. 


User Action: None. 


DIVBYZERO, at tag or text, line n, file 


file-spec 
Argument 2 to tag <COUNTER> is attempting to divide by zero 


Warning: Division by zero is undefined. (Processing continues. The result 
is as if a divisor of 1 had been used.) 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


DUPHIDNAM, at tag or text, line n, file 


file-spec 
A <HIDE_TAGS> tag is reusing the hide-name, string 


Warning: The hide-name is already in use. Once tags have been hidden 
under a specific hide-name, that hide-name cannot again be used until the 
tags have been revealed with the <REVEAL_TAGS> tag. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


DUPSYMBOL, at tag or text, line 7, file 


file-spec 
The symbol string is being defined twice. 
The earlier definition is replaced by the new definition 


Warning: The same symbol is being defined for two different purposes. 
The tag translator requires that each symbol be unique. If your symbols 
exceed 31 characters in length, the automatic truncation to 31 characters 
may be causing two different symbols to look alike. 


User Action: Verify that both symbols are defined uniquely within the 
first 31 characters. 
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EDIT_CODE, at tag or text, line 7, file 
file-spec 
Argument number has illegal action code char 
Error: The character shown is not one of the allowed action codes. 


User Action: Correct the indicated argument to the tag. 


EDIT_LNEQ, at tag or text, line n, file 
file-spec 
Lengths of delimiter, action, substitute strings are not equal 
Error: The number of delimiter characters and the number of action 
codes in one of the action strings or substitute characters in the substitute 
string are not the same. 


User Action: Correct the delimiter, action, or substitute arguments to the 
tag. 


ENDNOTBEG, at tag or text, line n, file 
file-spec 
<tagname> specified without corresponding <tagname>. 


Warning: A terminating tag was specified without the tag that it 
terminates. The tag is ignored. 


User Action: Verify that you correctly entered the beginning tag, or 
remove the extraneous ending tag from your source file. 


ENDPASS_1, End of first pass over the input 


Informational: The tag translator reports the end of the first pass over 
all input files. Error messages that appear ahead of this message were 
issued during the first pass. Error messages that follow this message are 
issued during the second pass over the input files. 


User Action: None. 


EOFARGLST, End of file encountered while searching for closing 
parenthesis. See argument list of tag <tagname> on line 
number of file 
filename 


Fatal: An argument list is not terminated before the end of the current 
input file. Either a right parenthesis is missing or an <INCLUDE> tag 
occurred in a tag’s argument list. 


User Action: Verify that the indicated tag’s argument list is terminated 
and that no tag’s argument list is unterminated at the end of an included 
file. 
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EOFCOLECT, End of file encountered while searching for tag <tagname>. 
See <COLLECT> or <PROTECT> tag on line number of file 
filename 


Fatal: A <COLLECT> or <PROTECT> built-in tag has encountered an end of 
file before encountering the indicated stop-tag. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


EOFENDCAS, End of file encountered while searching for tag <ENDCASE>. 
See <CASE> or <CASE_NUMERIC> tag on line number of file 
filename 


Fatal: A <CASE> (or <CASE_NUMERIC>) built-in tag is not terminated before 
the end of file. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


EOFENDCOM, End of file encountered while searching for tag 
<ENDCOMMENT>. 
See <COMMENT> tag on line number of file 
filename 


Fatal: Comment text, introduced by the <COMMENT> built-in tag, was not 
enclosed as an argument, and therefore requires an <ENDCOMMENT> tag as 
a terminator. 


User Action: Verify that the comment text is either enclosed as an 
argument to the <COMMENT> built-in tag or that it is terminated with an 
<ENDCOMMENT> tag. 


EOFENDLIT, End of file encountered while searching for <ENDLITERAL> 
or <ENDDELAYED>. See <LITERAL> or <DELAYED> tag on line 
number of file 
filename 


Fatal: Literal text, introduced by the <LITERAL> or <DELAYED> tag, was 
not enclosed as an argument, and therefore requires an <ENDLITERAL> or 
<ENDDELAYED> tag as a terminator. 


User Action: Verify that the literal text is either enclosed as an argument 
to the <LITERAL> or <DELAYED> tag or that it is terminated with an 
<ENDLITERAL> or <ENDDELAYED> tag. 


EOFIGNORE, at tag or text, line n, file 
file-spec 
End of file encountered while searching for tag or label 


Fatal: An <IGNORE> built-in tag has encountered the end of the input file 
without finding one of the tags or labels supplied in the argument list. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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ERRCLSINP, at tag or text, line 7, file 
file-spec 
Input files not closed at end of pass. 


Fatal: Files that were included as part of the input have not been properly 
closed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ERRDEFLNM, at tag or text, line n, file 
file-spec 
Attempt to define logical name was unsuccessful 
Logical: string 
Equivalence:string 
Warning: An <INCLUDES_FILE> tag in the <PROFILE> template has failed in 
its attempt to define the logical name with the given equivalence string. 


User Action: Examine the arguments to the <INCLUDES_FILE> tag to 
ensure that they are a correctly formed name and a file specification. 
Correct the <INCLUDES_FILE> arguments. 


ERRDURGET, at tag or text, line n, file 
file-spec 
Error reading line number of file: 
filename. 
Perhaps the line is too long 


Warning: The indicated line probably exceeds the tag translator’s buffer 
size. Processing continues with a truncated line (which may introduce 
other errors if the information that was lost includes part of an argument 
list to a tag). 


User Action: Edit the input file and shorten the line or break it into two 
lines, if possible. 


ERRDURPUT, at tag or text, line n, file 

| file-spec 
Error detected writing output file: 
filename 


Fatal: An error was detected while attempting to write to the indicated 
output file. 


User Action: Check that your process has sufficient privilege and access 
rights and that.the output device has sufficient free space to hold the file. 


ERROPEAUX, at tag or text, line n, file 
file-spec 
Cannot open auxiliary file: 
filename 
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Warning: An attempt to open an auxiliary file failed. The next 
Informational message may supply the reason for the failure. Processing 
continues, but attempts to read or write the auxiliary file will fail and will 
generate error messages. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ERROPEDMFP, |§ at tag or text, line n, file 
file-spec 
Cannot open dump file: 
filename 


Warning: The <RETRIEVE> built-in tag has failed to open a file for output. 
The next Informational message may indicate the reason for the failure. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ERROPEINC, at tag or text, line n, file 
file-spec 
Cannot open included file: 
filename 


. Warning: The indicated file cannot be opened for input. The next 
Informational message may indicate the reason for the failure. Processing 
continues without the included file. 


User Action: Verify that the correct file is being accessed and can be 
read. If you are using a logical name to access the file, verify that the 
logical name is defined. If you are relying on an <INCLUDES_FILE> tag to 
define the logical name, verify that the spelling of the logical name is the 
same in the <INCLUDES_FILE> tag, and that the <INCLUDES_FILE> tag has 
been specified for the book element that contains the <INCLUDE> tag.. 


ERROPEINP, at tag or text, line n, file 
file-spec 
Cannot open input file: 
filename 


Fatal: The input file specified on the command line cannot be opened. 
The next Informational message may indicate the reason for the failure. 


User Action: Verify that the correct file is being accessed and can be 
read. 


ERROPELOG, at tag or text, line 7, file 
file-spec 
Cannot open log file: 
filename 


Warning: The <SET> built-in tag has failed to open a file for trace output. 
The next Informational message may indicate the reason for the failure. 
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User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ERROPEOUT, at tag or text, line n, file 
file-spec 
Cannot open output file: 
filename 


Fatal: The tag translator cannot open the output file. The next 
Informational message may indicate the reason for the failure. 


User Action: Verify that the file specification is correct and that you have 
sufficient resources and access rights to create the file. 


ERROPESEC, at tag or text, line n, file 
file-spec 
Cannot open secondary output file: 
filename 


Warning: An attempt to open a secondary output file failed. Processing 
continues, but output will go to the primary output file. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ERROPESIN, at tag or text, line n, file 
file-spec 
Cannot open cross reference input file: 
filename 


Fatal: The tag translator failed to open the file that contains the symbols 
used for cross-references. The next information message indicates the 
reason for the failure. 


User Action: The file that contains the symbols used in cross-referencing 
can be used by only one user at a time. The tag translator locks the file to 
ensure that users have only serial access to it. If the reason for the failure 
to open the file was due to the fact that another user was currently using 
the file, you must wait and reissue the command when the file is no longer 
in use. 


ERROPESOT, at tag or text, line n, file 
file-spec 
Cannot open cross reference output file: 
filename 


Fatal: The tag translator failed to open a file for writing the symbols used 
for cross references. The next Informational message may indicate the 
reason for the failure. 


User Action: Verify that you have sufficient resources and access rights 
to create the file. 
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ERRPRSFSP, at tag or text, line 7, file 
file-spec 
Error parsing file specification: 
filename 
Warning: The file specification contains an error. 


User Action: Correct the file specification or logical name definition. 


ERRVMZONE, at tag or text, line n, file 
file-spec 
Internal error. Failure to create VM zone. 


Fatal: The tag translator failed to create space in virtual memory for 
storage of data. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


EXAMINLIN, Examine line number of file filename 


Informational: This message follows other messages of greater severity, 
and directs you to a possible error in the input. 


User Action: Use the information to examine and correct your input. 
EXFOOTNOT, at tag or text, line n, file 


file-spec 
Footnotes in a monospaced example exceeds maximum of 4. 


Warning: You have specified more than four <FOOTNOTE> tags in a <CODE_ 
EXAMPLE> or other monospaced example. The maximum allowed is four. 
The footnote will not be processed. 


User Action: Correct the source file by removing the extraneous 
footnotes. 


EXPAPPLET, Explicit appendix letter string set on line number of file 
filename 


Informational: Warns that the letter assigned to the next <APPENDIX> 
tag has been supplied explicitly by a <SET_APPENDIX_LETTER> tag. The 
appendixes may be lettered out of sequence. 


User Action: None. 
EXPAPPNUM, Explicit appendix number number set on line number of file 
filename 


Informational: Warns that the number assigned to the next <APPENDIX> 
tag has been supplied explicitly by a <SET_APPENDIX_NUMBER> tag. The 
appendices may be numbered out of sequence. 


User Action: None. 
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EXPCHAPNO, Explicit chapter number number set on line number of file 
filename 


Informational: Warns that the number assigned to the next <CHAPTER> 
tag has been supplied explicitly by a <SET_CHAPTER_NUMBER> tag. The 
chapters may be numbered out of sequence. 


User Action: None. 


FILEWRING, File filename written (0 length) 


Informational: An Error or Fatal message has been issued during the 
tag translation of a book element. The output file for that book element is 
reduced to 0 length. 


User Action: Correct the problems indicated in the Error and Fatal 
messages and reprocess. 


FILEWRTOK, File filename written 


Informational: An element of a book has been processed through the tag 
translation phase. 


User Action: None. 


FCMDPARMS, at tag or text, line n, file 
file-spec 
<tagname> specified without <tagname> in Format. 
Using <tagname> alone 


Warning: The tags <FCMD> and <FPARMS> must be used together to 
produce predictable results. 


User Action: Modify your source file so that it contains both the <FCMD> 
and <FPARMS> tags. Arguments to either of these tags may be null, that is, 
it is valid to specify <FCMD>. 


FIGINDENT, at tag or text, line n, file 
file-spec 
The value number specified for a block indent exceeds the 
current allowed maximum of number. 


Warning: A <FIGURE_FILE> tag specified the INDENT argument and a 
value that exceeds the current maximum allowed. The maximum value 
will be used. 


User Action: Correct the numeric argument specified with INDENT so 
that it does not exceed the indicated maximum. 


FIGLINMAX, at tag c or text, line n, file 
file-spec 
Monospaced example lines in <tagname> exceed maximum 
number. 


Error: A monospaced example specified in the context of a <FIGURE> or 
<EXAMPLE> tags is too long to fit on the current page, and either no 
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<VALID_BREAK> tags were specified to provide valid break points, or there 
are too many lines between <VALID_BREAK> tags. 


User Action: Put <VALID_BREAK> tags at suitable places in the 
monospaced example to allow the pages to break automatically. 


FIG_DEPTH, at tag or text, line 7, file 


file-spec 
Tag <tagname> value number exceeds the maxinitum NUMBER 
or is 0. 


Warning: The indicated tag specifies a depth for a figure or space to be 
left for a figure that will overrun the page boundaries. Or, the argument 
was specified as 0. In either case, the document’s default full page depth 
will be used. 


User Action: Correct the tag so that you specify no more than the 
maximum allowed. 


FIG_WIDTH, at tag or text, line n, file 


file-spec 
Tag <tagname> value number exceeds the maximum NUMBER 
or is 0. 


Warning: The indicated tag specifies a width for a figure or space to be 
left for a figure that will overrun the page boundaries. Or, the argument 
was specified as 0. In either case, the document’s default full page width 
will be used. 


User Action: Correct the tag so that you specify no more than the 
maximum allowed. 


FILENUMNG, at tag or text, line n, file 


file-spec 
File number is out of range 


Warning: A number supplied to the <FILE_LNAME> tag is not within the 
range of 1 to the number of files that have been opened. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


FILISOPEN, at tag or text, line n, file 


file-spec 
Auxiliary file: 
filename 

is already open 


Warning: An <OPEN> built-in tag is specifying a file that is already open. 
The request is ignored and processing continues. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


Messages 
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FILNOTOPN, at tag or text, line n, file 
file-spec 
Auxiliary file: 
filename 
is not open 


Warning: A <READ> or <WRITE> built-in tag is addressing a file that has 
not been opened. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


FMTDEVICE, Tag <tagname> produces device-specific output. 


Informational: A tag that produces specific formatting controls has 
been processed. The output may not be suitable if the file is processed 
for another doctype, destination, or both. For example, <FINAL_ 
CLEANUP>(LINE_BREAK) tells the text processor to create a new line of 
output, but the line break may not be suitable on all output devices. 


User Action: Use explicit formatting commands sparingly. 


GTMAXARGS, at tag or text, line n, file 
file-spec 
More than number arguments supplied to tag <tagname> 
Error: The indicated tag does not expect more than the indicated number 
of arguments. You may have included a backslash character in one of the 
arguments, which the tag translator interpreted as an argument separator. 


User Action: Verify that the argument list is correctly coded. If 
necessary, use the <BACKSLASH> tag to code a backslash character that 
is actually part of an argument. 


HIDNOTHID, at tag or text, line n, file 
file-spec 
Internal error. A hidden tag was invoked, 
but was not found in the data structure of hidden tag names 


Fatal: The algorithm for hiding and revealing tags has failed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ICON_TEXT, at tag or text, line 7, file 
file-spee 
No text supplied for <ICON>. 


Warning: An <ICON> tag was specified, but no <ICON_TEXT> tag specified 
text to accompany the graphics. No text will be output. 


User Action: Verify that you specified <ICON_TEXT> correctly. 
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IGNAMEILL, at tag or text, line n, file 
file-spec 
Argument string to <IGNORE> is illegal 


Warning: The argument is not a legal name or label. The argument is 
dropped from the argument list, and processing continues. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


IGNAMEMIS, at tag or text, line n, file 
file-spec 
An argument to <IGNORE> tag is a null string 
Warning: One of the arguments to an <IGNORE> tag is empty. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

IGNOREARG, Ignoring the argument 


Informational: This message usually accompanies other error messages 
that indicate a faulty argument. It indicates that the faulty argument is 
being ignored. 


User Action: Correct the SDML file. 
IGNORESET, Ignoring <tagname> on line number of file 
filename 


Informational: This tag is ignored when doing a book build or element 
build, because the numbering of book elements is done automatically. 


User Action: Remove the tag. 
IGNOTDONE, at tag or text, line n, file 


file-spec 
The <IGNORE> tag has no arguments, so it is ignored 


Warning: Missing or illegal arguments have resulted in an <IGNORE> tag 
that has no legal arguments. The <IGNORE> tag is not executed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INCNOTARG, at tag or text, line n, file 
. file-spec 
An <INCLUDE> tag cannot be invoked in an argument 


Error: An <INCLUDE> tag can be invoked only in text. 
User Action: Move the <INCLUDE> tag outside the argument list. 


B-26 


Messages 
Tag Translator Messages 


INCOVRFLW, at tag or text, line n, file 
file-spec 
More than number nested levels of included files 


Fatal: The number of included files that can be open at the same time is 
limited. The limit has been exceeded. 


User Action: Consider whether the included files can be included 
sequentially rather than simultaneously. If file A includes file B, and 
file B includes file C, consider whether file A can include both B and C, 
one after the other. 


INDENTVAL, at tag or text, line n, file 
file-spec 
The <tagname> specifies an indent value of number. 
This exceeds the maximum number allowed for this tag. 


Warning: The INDENT argument to the specified tag specified an indent 
value that exceeds the maximum allowed. The maximum value will be 
used. 


User Action: Correct the tag to specify an indent value less than or equal 
to the maximum allowed. 


INT_LOGIC, at tag or text, line n, file 
file-spec 
Internal error processing tag <NAME> 


Error: An SDML tag definition has an error in it. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INVINHELP, Tag <tagname> being ignored for HELP processing. 


Informational: The SDML tag used is invalid in the HELP doctype. The 
tag and its arguments are ignored. 


User Action: None. 
INVLDDEST, at tag or text, line n, file 


file-spec 
Destination string is invalid with the string doctype. 


Fatal: The destination is invalid with the doctype used. 


User Action: Check to see that the doctype and destination you are using 
are compatible. 


ISTHISTAG, at tag or text, line n, file 
file-spec 
Ignoring <string terminated by char. 
Is this a tag without a closing angle bracket? 


Warning: An apparent tag name has been found, but without the closing 
angle bracket that is needed to make it a complete tag invocation. 
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User Action: If this is a typing error, simply add the closing angle 
bracket. If this is not a typing error (you really want the left angle bracket 
and the tag name to appear in the output), use the <LITERAL> tag to 
enclose the left angle bracket. 


KEYPADROW, at tag or text, line n, file 


file-spec 
Too many keypad rows. Extra rows ignored 
Warning: A set of tags within a <KEYPAD_SECTION> specifies more than 


four <KEYPAD_ROW> tags. The keyboard keypad has only four rows and one 
end row. 


User Action: Determine which <KEYPAD_ROW> tag is extra and remove it 
from your source file. 


LASTAGWAS, Last occurrence of <tagname> was on line number 


Informational: This message is issued when a tag is not ended before a 
particular context or the end-of-file. It tells you the line number of the last 
occurrence of the tag. 


User Action: Use the indicated line number to determine where to correct 
your source file. 


LISTYPWAS, List type was string 


Informational: This message accompanies an error that indicates that a 
<LIST> tag was not terminated. It indicates the type of list, for example, 
NUMBERED, UNNUMBERED, and so on. 


User Action: Use this information to correct your SDML source file. 


LITOVRFLW, More than number characters in literal. See line number of file 


filespec 


Fatal: The size of the text encompassed by a <LITERAL> or <DELAYED> tag 
is limited. This error may indicate that a <LITERAL> or <DELAYED> tag was 
incorrectly terminated. 


User Action: Verify that the <LITERAL> or <DELAYED> tag has been 
correctly coded. If the text to be encompassed by the tag exceeds the limit, 
you must break it up and use more than one <LITERAL> or <DELAYED> tag. 


LMF_NOLMF, at tag or text, line n, file 


file-spec 
No LMF information is specified for this document 


Warning: LMF information is missing. 


User Action: Check to ensure that the LMF information exists if it is 
required for your document. Sometimes, incorrect use of the <REFERENCE> 
tag within the argument to the <TITLE> tag causes this problem. 
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LMFINFAFT, at tag or text, line 7, file 
file-spec 
Make sure <tagname> is specified after the LMF tags. 
No LMF information is written out. 


Warning: The <LMF_INFO> tag may be specified before the LMF tags. 


User Action: You may want to check to ensure that the LMF tags are 
coded before the <LMF_INFO> tag. 


LMFNOALTN, at tag or text, line n, file 
file-spec 
Tag <tagname> may be missing 


Warning: An <LMF_ALTNAME> tag may be missing. 


User Action: Although this tag is not required, you may want to check to 
ensure that, if it exists, it is not miscoded. 


LMFNOINFO, at tag or text, line 7, file 
file-spec 
Missing <LMF_INFO> tag. 


Warning: The <LMF_INFO> tag is missing. 


User Action: Check to ensure that the LMF information exists if it is 
required for your document. 


LMFTAGMSG, at tag or text, line n, file 
file-spec 
Tag <tagname> is missing 
Error: An LMF tag is missing. 


User Action: Check to ensure that the <LMF_PRODUCER>, <LMF_PRODUCT>, 
<LMF_RELEASE_DATE>, and <LMF_VERSION_NUMBER> tags exist. 


LMF_TOMNY, at tag or text, line n, file 
file-spec 
LMF information is specified more than once for this document 


Error: LMF information is specified more than once for this document. 


User Action: You can specify LMF information only once for each 
document. Check for too many <LMF> tags. 


LTMINARGS, at tag or text, line n, file 
file-spec . 
Fewer than number arguments supplied to tag <tagname> 


Error: The indicated tag requires a minimum number of arguments. 
Perhaps one of the arguments has an unmatched right parenthesis in it, 
and the tag translator has treated that character as the terminator of the 
argument list. 


User Action: Review and correct the argument list. Be sure that the 
open parenthesis for the argument list is not preceded with a space; for 
example <TAG> (ARG) should be <TAG>(ARG). 
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MARKUNBAL, at tag or text, line n, file 
file-spec 
<MARK> tags are unbalanced. 


Error: A <MARK> tag and its corresponding <ENDMARK> tag cross a tag’s 
boundary or are incorrectly nested with respect to another pair of tags. 
For example, if a <MARK> tag is specified before <FORMAT> and <ENDMARK> 
is specified before <ENDFORMAT>, the tags are considered unbalanced. 


User Action: Find the source file location of the indicated tag and move 
it. In particular look for instances where a <MARK> tag is specified in a tag 
argument, but the <ENDMARK> tag is specified outside that tag’s argument 
or in an argument to another tag. 


MILNOCLSS, No security classification has been specified 


Informational: The <HIGHEST_SECURITY_CLASS> tag has been specified to 
output the highest security classification. However, no <SECURITY> tags 
have been specified in the document to provide a classification and so no 
output will be produced. 


User Action: Add a <SECURITY> tag to indicate the document’s security 
classification or remove the <HIGHEST_SECURITY_CLASS> tag. 


MINEXCMAX, at tag or text, line n, file 
file-spec 
Minimum argument count (number) exceeds maximum 
argument count (number). 
(Minimum argument count is being reset to zero) 


Warning: A <DEFINE> or <REDEFINE> tag is specifying a minimum and 
maximum number of arguments and the minimum exceeds the maximum. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MSGIDISNG, at tag or text, line n, file 
file-spec 
The message identification string is invalid. 
The <HIDE_TAGS> tag is ignored 


Warning: The second argument to a <HIDE_TAGS> tag is supplying an 
unknown message identification. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NAME2LONG, at tag or text, line n, file 
file-spec 
Condition name string exceeds 28 characters 


Error: Condition names may not exceed 28 characters in length. 


User Action: Shorten this name (and any other condition names that are 
too long) to 28 characters or less. 
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NAMETRUNCGC, at tag or text, line 7, file 
file-spec 
Name string exceeds 31 characters. 
Name string is truncated version 


Warning: Names may not exceed 31 characters in length. The name 
that was supplied is a legal name, but it is too long. It is truncated to 31 
characters. 


If more than one name is truncated, the shortened names may not be 
unique and other errors may occur depending on the type of name. 


User Action: Shorten this name (and any other names that are too long) 
to 31 characters or less, so that there is no potential for other errors. 


NESTEDCOM, A <COMMENT> tag on line number of file 
filename 
is nested within <COMMENT> ... <ENDCOMMENT> that starts 


on line number of file 
filename 


Warning: <COMMENT> tags cannot be nested. 


Sometimes an error is made in typing a <COMMENT> tag in the format 
<COMMENT>(text). The typing erro makes it appear that the tag does 
not have an argument list, and it is assumed that an <ENDCOMMENT> 
tag is present to end the comment text. During the search for the 
<ENDCOMMENT> tag, if another <COMMENT> tag is encountered it will 
appear to be nested within the first <CcOMMENT> tag’s text. 


User Action: Correct any typographical errors in the initial <CcOMMENT> 
tag or remove the nested <COMMENT> tag. 


NOBCKNOTE, at tag or text, line n, file 
file-spec 
Accumulated back notes not referenced. 
Notes will not be output 


Warning: A document contained <BACK_NOTE> tags, but no corresponding 
<BACK_NOTES> tag was specified to output the accumulated notes. 


User Action: Place the <BACK_NOTES> tag in the source file at the position 
at which you want them output. 


NOBIBNOTE, at tag or text, line n, file 
file-spec 
Accumulated bibliographic notes not referenced. 
Notes will not be output 


Warning: A document contained <BIB_NOTE> tags, but no corresponding 
<BIB_NOTES> tag was specified to output the accumulated notes. 


User Action: Place the <BIB_LNOTES> tag in the source file at the position 
at which you want them output. 
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NOCONFILE, at tag or text, line n, file 


file-spec 
<CONTENTS_FILE> tag specified without /CONTENTS qualifier. 
No new file will be generated. 


Warning: A <CONTENTS_FILE> tag was encountered in the input file, 
but the corresponding /CONTENTS qualifier was not present on the 
command line. No new contents file will be produced. An earlier version 
of a contents file, if it exists, may be included in the output. 


User Action: If you want to include a current table of contents file, 
you should reissue the DOCUMENT command using the /CONTENTS 
qualifier. 


NODEFITEM, at tag or text, line n, file 


file-spec 
Definition list specified no items before <tagname>. 


Warning: A <DEFINITION_LIST> tag, or a corresponding tag in the 
SOFTWARE doctype, was specified but no <DEFLIST_ITEM>/<DEFLIST_DEF> 
tags were specified for the list. No output will be produced. 


User Action: Remove the definition list start/end tags or provide item 
text for the definition list. 


NOENDPROF, at tag or text, line n, file 


file-spec 
The <PROFILE> tag was not terminated by an <ENDPROFILE> tag 


Warning: In order for the book build process to be completed, the 


<PROFILE> tag must be terminated by an <ENDPROFILE> tag. The 
<ENDPROFILE> tag is supplied by default in this case. 


User Action: If the <PROFILE> tag is not terminated by an <ENDPROFILE> 
tag, add one after the final <ELEMENT> or <INCLUDES_FILE> tag. 


NOFIGELMS, at tag or text, line n, file 


file-spec 
<tagname> has no elements. 
Warning: A <FIGURE> or <EXAMPLE> tag was specified and terminated 


but there were no elements (for example, <FIGURE_SPACE>) to place in the 
figure. 


User Action: Verify that you correctly spelled and entered tags for the 
figure or example. 


NOHIDERVL, at tag or text, line 7, file 


file-spec 
Ignoring request to hide the <REVEAL_TAGS> tag 


Warning: The <REVEAL_TAGS> built-in tag cannot be hidden by the action 
of a <HIDE_TAGS> built-in tag. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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NOINXFILE, at tag or text, line n, file 
file-spec 
<INDEX_FILE> tag specified without /INDEX qualifier. No new 
file will be generated. 


Warning: An <INDEX_FILE> tag was encountered in the input file, but the 
corresponding /INDEX qualifier was not present on the command line. No 
new index file will be produced. An earlier version of an index file, if it 
exists, may be included in the output. 


User Action: If you want to include a current index file, you should 
reissue the DOCUMENT command using the /INDEX qualifier. 


NONESTING, at tag or text, line n, file 
file-spec 
Invalid attempt to nest tag <tagname>. Ignored 


Warning: A tag is referenced when its context is already active. For 
example, this message is issued when <CODE_EXAMPLE> is specified when a 
previous <CODE_EXAMPLE> is not terminated. 


User Action: The indicated tag is ignored; however, you should verify 
your source file to determine whether the tag is a duplicate or whether, in 
fact, you did not terminate an earlier occurrence of the same tag. 


NONEWFILE, at tag or text, line n, file 
file-spec 
<tagname> specified without string. No new file will be 
generated. 


Warning: A <CONTENTS_FILE> or <INDEX_FILE> was encountered in the 
input file, but the corresponding /CONTENTS or /INDEX qualifier was not 
present on the command line. No new contents or index will be produced. 
An earlier version of a contents or index file, if it exists, may be included 
in the output. 


User Action: If you want to include the current table of contents or index 
file, you should reissue the DOCUMENT command using the appropriate 
qualifier. 


NOPROFILE, at tag or text, line n, file 
file-spec 
Tag can appear only following a <PROFILE> tag 


Fatal: The tag is part of a profile and can be used only in that context 
and only within the same file as the <PROFILE> tag. 


User Action: Check that the tag appears after a <PROFILE> tag and in the 
same file as the <PROFILE> tag. 
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NOREADOUT, at tag or text, line n, file 


file-spec 

Cannot read from file: 
filename 

The file is opened as output 


Warning: A <READ> built-in tag cannot be addressed to an auxiliary file 
that is opened as output. (The <OPEN> tag defaults to output mode unless 
INPUT is specified.) 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOREFNOTE, at tag or text, line 7, file 


file-spec 
Accumulated reference notes not referenced. 
Notes will not be output 


Warning: A document contained <REF_NOTE> tags, but no corresponding 
<REF_NOTES> tag was specified to output the accumulated notes. 


User Action: Place the <REF_NOTES> tag in the source file at the position 
at which you want them output. 


NOTDOCTYP, at tag or text, line n, file 


file-spec 
Tag <tagname> is not allowed in the string doctype 


Error: The indicated tag is not meaningful in the context of the doctype 
specified on the command line and cannot be processed. For example, the 
LETTER doctype does not allow <CHAPTER> or heading-level tags. 


User Action: Verify that you specify the correct doctype keyword on the 
DOCUMENT command line. If the doctype is correct, remove the tags 
from the SDML source file. 


NOTHIDNAM, at tag or text, line n, file 


file-spec 
A <REVEAL_TAGS> tag is referencing an unknown hide-name, 
string 


Warning: The hide-name specified by a <REVEAL_TAGS> tag is not in use. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOTINELEM, at tag or text, line n, file 


file-spec 

Tag can appear only within the context established by 

an element heading tag such as <CHAPTER>, <PART>, and so 
forth. 
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Error: When a book build is done, all text and the tags that accompany 
the text must appear within some element of the book. The text and tags 
must follow the element heading tag in order to be considered to be in the 
context of the element. 


User Action: Correct the source text so that the tag that is in error 
follows a tag that heads an element of the book. 


NOTINPROF, at tag or text, line n, file 
file-spec 
The <tagname> tag must appear in the same file as the 
<PROFILE> tag 


Error: All the tags that make up a profile must appear in the same file. 


User Action: Move the tag into the same file as the <PROFILE> tag. 


NOUNDEFBI, at tag or text, line n, file 
file-spec 
Ignoring <UNDEFINE> or <REDEFINE> of the built-in definition of 
<tagname> . 


Warning: A tag translator built-in tag cannot be deleted by the action of 
a <REDEFINE> or <UNDEFINE>. The built-in tag can be “stacked” by issuing 
a <DEFINE> tag for it, however. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOWRITEIN, at tag or text, line n, file 
file-spec 
Cannot write to file: 
filename 
The file is opened as input 


Warning: The <WRITE> built-in tag cannot write to an auxiliary file that 
has been explicitly opened as input. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOZONEYET, at tag or text, line n, file 
file-spec 
Tag <tagname> specified outside its valid zone or context. 
It must be preceded by tag <tagname>. 


Error: A tag was specified outside the context that enables it, for 
example, a <COPYRIGHT_PAGE> tag was specified when the tag <FRONT_ 
MATTER> has not been specified to enable the front matter zone. 


User Action: Be sure that you have specified the correct tag. Add the 
appropriate zone-enabling tag. 
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NO_OUTPUT, No output is produced for this tag 


Informational: This message accompanies other warning messages. It 
indicates that the tag is being ignored and no output is produced. 


User Action: Correct the SDML file to remove the other warning 
messages. 


NO_PREFIX, at tag or text, line n, file 


file-spec 
No character string prefix is available. 
Warning: A tag in a template specified that a character-string prefix 


was to be used for page or formal element numbering, but no prefix was 
specified. 


User Action: Specify a prefix for the section in the <SET_TEMPLATE_ 
PREFIX> tag. 


NUMBERARG, at tag or text, line 7, file 


file-spec 
Argument number is not valid for <tagname>. 


Warning: The numeric argument is not valid for the tag. 


User Action: Consult the tag’s documentation to determine the valid 
values. 


NUMLTZERO, The argument is less than 0. 


Informational: This message accompanies a message about an invalid 
numeric argument. It indicates that a negative value was specified for a 
tag argument which must be a positive number. 


User Action: Consult the documentation to determine the tag’s valid 
values. 


O_ARGNTNM, at tag or text, line n, file 


file-spec 

Argument number to tag <tagname> is not.a valid name 
Error: The indicated argument does not obey the rules for formation of 
a name. A name can have only letters, numbers, and underscores and a 


name cannot begin with two underscores. You can use spaces, tabs, and 
carriage returns. 


User Action: Correct the argument so that the name is valid. 


O_DFINTAG, at tag or text, line n, file 


file-spec 
A <DEFINE> tag should be removed from this file. 
Consider using a <DEFINE_SYMBOL> tag in its place. 


Fatal: The definition of the <DEFINE> tag will not appear in the modified 
source file. 


User Action: Tag definitions should be in separate files called with the 
/SYMBOLS qualifier on the command line. 
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O_FNOTPRB, at tag or text, line n, file 
file-spec 
Possible problem with footnotes 


Warning: The software has detected a possible problem with footnotes. 


User Action: Check to ensure that all footnotes are coded correctly. 


O_IGNRTAG, at tag or text, line n, file 
file-spec 
Ignoring <tagname>. 
You have specified multiple <tagname> tags with the MASTER 


argument, 

ignoring all but the first tag. 
Warning: Multiple <SET_ONLINE_TOPIC> tags with the MASTER argument 
have been specified. 


User Action: Remove the extra <SET_ONLINE_TOPIC> tags. 


O_TAGMISN, at tag or text, line n, file 
file-spec 
Tag <tagname> is missing 


Warning: A Bookreader <ONLINE_PART_NUMBER> tag is missing. 


User Action: Check to ensure that the <ONLINE_PART_NUMBER> tag exists 
if it is required for your document. 


O_TMNYXTR, at tag or text, line n, file 
file-spec 
More than 25 characters in argument to tag <tagname>. 
Fatal: There is a limit of 25 characters in the argument to the <SYMBOL_ 
PREFIX> tag. 
User Action: Check to ensure that the argument to the <SYMBOL_PREFIX> 
tag has no more than 25 characters. 


OBKSYMMSG, at tag or text, line n, file 
file-spec 
Book does not contain a valid book symbol name. 


Warning: The book is missing a valid book symbol name. 
User Action: Check to ensure that the <ONLINE_INFO_SYMBOL> tag exists 
if it is required for your document. 


OCONTOMNY, at tag or text, line n, file 
file-spec 
Too many <tagname> tags. 


Fatal: Too many <CONTENTS_FILE> tags have been defined for this 
- document. 


User Action: Bookreader documents are limited to one <CONTENTS_FILE> 
tag. Check for too many <CONTENTS_FILE> tags. 
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OENONSTNG, at tag or text, line n, file 
file-spec 
Invalid attempt to nest tag <tagname>. | 
Error: A tag is referenced when its context is already active. For 
example, this message is issued when an <ONLINE_POPUP> tag exists 
after a previous <ONLINE_POPUP> tag that you did not terminate. 


User Action: The indicated tag is ignored; however, you should verify 
your source file to determine whether the tag is a duplicate or whether, in 
fact, you did not terminate an earlier occurrence of the same tag. 


OESYMISNG, at tag or text, line 7, file 
file-spec 
Missing symbol argument to a <tagname> tag. 
Symbol names are required when referencing headings, 
formal tables, examples, and figures. 


Error: Symbols are required when referencing headings, formal tables, 
examples, and figures in Bookreader doctypes. 


User Action: Supply a symbol name as an argument to the tag. You may 
want to use the /(GENERATE_SYMBOL qualifier to automatically generate 
missing symbols. 


OFILNOTCV, at tag or text, line n, file 
file-spec 
Cannot open new version of : 
filename 
File not converted. 


Warning: An attempt to open an included file failed. 


User Action: Verify that the file specification is correct, and that you 
have sufficient resources and access rights to create the file. 


OFNONSTEM, at tag or text, line 7, file 
file-spec . . 
Invalid attempt to place tag <tagname> within <ONLINE_ 
POPUP>/<ENDONLINE_POPUP> tags. 


Fatal: <HEADn> tags, formal examples, figures, and tables are not allowed 
between <ONLINE_POPUP>/<ENDONLINE_POPUP> tags. 


User Action: Either remove the <ONLINE_POPUP>/<ENDONLINE_POPUP> 
tags or use an informal example, figure, or table. Also, be sure no <HEADn> 
tags are in the popup. 


OFNONSTNG, at tag or text, line n, file 
file-spec 
Invalid attempt to nest tag <tagname>. 
Fatal: A tag is referenced when its context is already active. For example, 
this message is issued when an <ONLINE_POPUP> tag exists after a previous 
<ONLINE_POPUP> tag that you did not terminate. 
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User Action: The indicated tag is ignored; however, you should verify 
your source file to determine whether the tag is a duplicate or whether, in 
fact, you did not terminate an earlier occurrence of the same tag. 


OFONLCHNK, at tag or text, line n, file 
file-spec 
Invalid attempt to place tag <tagname> in a formal example, 
figure, or table. 


Fatal: <ONLINE_CHUNK> tags are not allowed in formal examples, figures, 
or tables. 


User Action: Remove the <ONLINE_CHUNK> tag or use an informal 
example, figure, or table. 


OHIVERNUM, at tag or text, line n, file 
file-spec a 
Version number detected on included file, string. 
‘Higher version of that file is being written. 


Warning: The tag translator has detected a version number on an 
included file. A file with a higher version number is being written. 


User Action: The source file has included a file with a specific version 
number and the symbol generator is writing a file with a higher version 
number. Either remove the version number or modify the file specification 
to the higher number. 


OINVPREFX, at tag or text, line n, file 
file-spec ; | | 
Invalid symbol argument to /PREFIX= qualifier on command 
line. 


Fatal: Invalid characters have been detected in the symbol argument to 
the /PREFIX= qualifier on the command line. 


User Action: Check to ensure that there are no invalid characters, such 
as dollar signs ($) or hyphens (-),.in the symbol argument to the /PREFIX 
qualifier on the command line. 


OSYMNTDEF, at tag or text, line n, file 
file-spec 
Symbol string is undefined 


Error: A symbol has been referenced but is not in the symbol table. 
User Action: Verify that the symbol is spelled correctly and that the 
same symbol has been entered in the symbol table. 


OTTLPGMSG, at tag or text, line n, file 
file-spec 
Tag <TITLE_PAGE> is missing 


Error: A <TITLE_PAGE> tag is missing. Bookreader doctypes require the 
<TITLE_PAGE> tag. 


User Action: Check to ensure that the <TITLE_PAGE> tag exists and is 
coded correctly. . 
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OTL_LEVEL, at tag or text, line n, file 
file-spec 
Outline level specified, number, is not in range 
The argument must specify 1 through 6 


Warning: An invalid number was specified in a <LEVEL> tag in an outline. 
Only levels of 1 through 6 are valid. 


User Action: Correct your source file so that no outline level has a 
number greater than 6. 


OTL_TITLE, at tag or text, line n, file 
file-spec 
<tagname> not valid within outlines. 
Enter the title as an argument to the <OUTLINE> tag 


Warning: A <TITLE> tag was specified within the context of the <OUTLINE> 
tags. 


User Action: Correct your source file so that the title of the outline is 
supplied in arguments to the <OUTLINE> tag. 


OUTLIN2BG, at tag or text, line n, file 
file-spec 
Output line exceeded number bytes, and had to be broken 


Warning: Text in an output line exceeded the tag translator’s buffer. No 
text was lost because the line was written as two lines, but the division 
into two lines may have broken a word into two words, or interfered with 
the correct formatting of the text. This usually happens when the tag 
translator inserts many formatting commands into an output line. It also 
happens when a tag reference on a long input line is replaced by a very 
long string of text. 


User Action: Check the formatted output that corresponds to the input 
line specified in the location information to see if breaking the line affected 
the formatting. 


PARSECODE, at tag or text, line n, file 
file-spec 
Argument number has illegal action code char 


Error: The character shown is not one of the allowed action codes. 


User Action: Correct the indicated argument to the tag. 


PARSELNEQ, at tag or text, line n, file 
file-spec 
Lengths of delimiter and action arguments are not equal 


Error: The number of delimiter characters and the number of action 
codes in one of the action strings are not the same. 


User Action: Correct the delimiter or action arguments to the tag. 
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POSTERROR, at tag or text, line n, file 
file-spec 
Error encountered during post-translation 


Fatal: An error has been detected during the final step in tag translation. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


PQLISNONE, at tag or text, line n, file 
file-spec 
<tagname> specifies NONE when no heading is specified 


Warning: The keyword argument “NONE” was specified to a 
<PARAMDEFLIST> or <QUALDEFLIST> tag in a context in which no default 
heading is in effect. The use of NONE in this context is meaningless. 


User Action: Determine if you intended to be using default headings for 
the <PARAMDEFLIST> or <QUALDEFLIST> tag. If not, remove the tag from 
your source file. Otherwise, verify whether you should have invoked one of 
the reference templates to set an environment for parameter/qualifier list 
descriptions. 


PROFORDER, at tag or text, line n, file 
file-spec 
<PROFILE> tag is out of order 


Fatal: A <PROFILE> tag has been detected after an element heading tag, 
such as <CHAPTER> or <APPENDIX>. 


User Action: Place a single <PROFILE> ... <ENDPROFILE> sequence in a 
file by itself in order to do a book build. 


PROFQ_ILL, at tag or text, line 7, file 
 file-spec 
/PROFILE qualifier illegal during a book build 
Fatal: The /PROFILE qualifier was supplied on the command line, 
indicating that an element build is desired, but the SDML file contains 
a <PROFILE> tag, indicating that a bookbuild is desired. The /PROFILE 


qualifier (which indicates an element build) should not be supplied when a 
bookbuild is desired. 


User Action: Invoke DOCUMENT without the /PROFILE qualifier. 
QUALVALUE, at tag or text, line n, file 


jile-spec 
Value string to /CONDITION qualifier is not a valid name 


Fatal: The condition name supplied with the /CONDITION qualifier 
must contain only alphabetic and numeric characters and the underscore 
character. 


User Action: Correct the spelling of the condition name. 
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Q_BAD_POS, at tag or text, line 7, file 
file-spec 
Argument 2, string, is invalid for queue name 


Error: A position argument supplied with a queueing built-in tag is 
invalid. The numeric value of the position may be out of range or an 
invalid keyword may have been used. 


User Action: Correct the tag’s position argument. 


Q NONUML_E, at tag or text, line n, file 
file-spec 
Entry in queue name is not numeric 


Error: An <ENQUE> tag has requested that a new value be inserted in 
a queue in numeric sorted order. During the insertion a non-numeric 
entry is discovered in the queue. This can happen only if the entry was 
enqueued by a method other than numeric sorted order. 


User Action: Review the <ENQUE> tags that insert entries on this queue 
and insure that all tags request a numeric sorted order. 


Q_ TOOLONG, at tag or text, line n, file 
file-spec 
Concatenation of all name queue entries exceeds max length 
Error: A <DEQUE>(name\ ALL\ RETURN) tag has been encountered. The 


concatenation of all the entries on the queue creates a single string that 
exceeds the maximum string length (65,012 bytes). 


User Action: Adopt a different queueing method, breaking the queue into 
more than one queue. 


REVISINFO, Document is using revision indicators 


Informational: Indicates that the <REVISION> tag is being processed. Text 
that is delimited by <MARK> and <ENDMARK> tags will be accompanied by 
revision indicators on output. 


User Action: If you intend for revision bars to print in your text, you do 
not need to take any action. However, if you intended for text indicated 
by <MARK> tags to not appear in the output, you should remove the 
<REVISION> tag from the file. 


REVISTEXT, Revised pages will contain the text string. 


Informational: This message verifies the text specified in the second 
argument to the revision tag and reminds you that only pages specified in 
an update range will be processed and printed. 


User Action: None. 
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REVIS_UPD, Revision will contain update pages only. 


Informational: This message reminds you that you specified 
<REVISION>(UPDATE) and that your output file will only contain the text 
for pages specified between <UPDATE_LRANGE> and <ENDUPDATE_RANGE> 
tags. 


User Action: None. 


REV_PAGES, Update pages number through number will be output 


Informational: This message indicates the pages that will be output for 
an update. 


User Action: None. 


RMVCONDTN, Removing condition condition-name 
on line number of file filespec 


Informational: A <SET_CONDITION>(REMOVE) tag is being executed. 


User Action: None. 


SAVTAGACT, at tag or text, line n, file 
file-spec 
Tag <tagname> has a before or after action that is 
ignored when saving a tag table 


Warning: You are attempting to invoke a tag that has a before action or 
an after action. The before action or after action cannot be executed while 
you are saving the tag in a tag table. The before action or after action will 
be executed when the saved tag table is loaded. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


SAVTAGILL, at tag or text, line n, file 
file-spec 
This built-in tag cannot be invoked during the saving of a tag 
table 


Error: Only certain built-in tags can be stored in a saved tag table for 
invocation when the saved tag table is loaded. This tag is not one that can 
be saved. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


SAVTAGLEV, at tag or text, line n, file 
file-spec 
Tag <tagname> cannot be invoked within an argument list 
during saving of a tag table 


Error: During the saving of a tag table, the arguments to all tags must 
be constant or must be made constant by quoting them. 
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User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


SDML_INFO, message 


Informational: An SDML tag is describing action taken during tag 
loading. 


User Action: None. 


SECFILOPN, at tag or text, line n, file 
file-spec 
Cannot open a secondary output file named 
filename 
A secondary output file is already open. It is named 
filename 


Error: Only one secondary output file can be open at a time. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


SETCONDTN, Setting condition condition-name 
on line number of file filespec 


Informational: A <SET_CONDITION> tag is being executed or a condition is 
being set in response to a /CONDITION qualifier on the command line. 


User Action: None. 


SKIPITEMS, at tag or text, line n, file 
file-spec 
number <tagname> outside of <tagname> skipped. 


Warning: This message is usually preceded by a message indicating that 
an <LE> or <TABLE_ROW> tag was encountered. It indicates the number of 
additional tags that were specified. The tags will not be processed, and 
will be written, unformatted, to the output file. 


User Action: Determine if the tags are considered invalid because there 
is no preceding <TABLE> or <LIST> tag, or if the <TABLE> or <LIST> tag was 
specified incorrectly. Correct your source file. 


STKOVRFLW, at tag or text, line n, file 
file-spec 
More than number nested levels of tags. (These are 
tags that are invoked inside other tags’ argument lists) 


Fatal: The tag translator limits the number of tags that can be invoked 
simultaneously. Tag B is invoked simultaneously with tag A, if it is 
invoked in the argument list to tag A. Thus, <A>(<B>(<C>)) requires that 
three tags are being invoked simultaneously. This may occur unexpectedly 
when the argument list to one of the tags is not properly terminated. 


User Action: Verify that the argument list of the tag that is specified in 
the location information has been properly terminated. 
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STRFREE2T, at tag or text, line n, file 
file-spec 
Internal error. Attempt to free the same string twice 


Fatal: The tag translator’s memory allocation algorithm has failed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


STRFREEBA, at tag or text, line n, file 
jile-spec 
Internal error. Attempt to free string with bad address 


Fatal: The tag translator’s memory allocation algorithm has failed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


STRTOOBIG, at tag or text, line n, file 
file-spec 
Internal error. Attempting to allocate number-byte string 


Fatal: The tag translator’s memory allocation algorithm has failed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. . 


SYMFREEBA, at tag or text, line n, file 
file-spec 
Internal error. Attempt to free symbol table entry with bad 
address 


Fatal: The tag translator’s memory allocation algorithm has failed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


SYMISSING, at tag or text, line n, file 
file-spec 
Missing symbol argument. 
Each book element must have a symbol argument 


Fatal: Each element of a book must have a unique symbol so that the 
element can be processed independently. The symbol table cannot be 
saved from this run. 


User Action: Supply a symbol as an argument to the tag. 
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SYMISUSED, at tag or text, line 7, file 
file-spec 
The symbol string is already in use as a symbol of type string 


Error: Each element of a book must have a unique symbol. You have 
supplied a symbol on this element of the book that conflicts with an earlier 
use of this symbol. The symbol table cannot be saved from this run. 


User Action: Correct the use of symbols on elements of the book so that 
each element has a unique symbol. If you are doing a book build you must 
repeat the book build in order to produce a good symbol table. If you are 
doing an element build, just correct the symbol in this tag so that this 
element of the book has a unique symbol, and then repeat the element 
build. 


SYMNOTDEF, at tag or text, line n, file 
file-spec 
Symbol string is undefined. 


Warning: A symbol has been referenced but is not in the symbol table. 


User Action: Verify that the symbol is spelled correctly and that the 
same symbol has been entered in the symbol table by the invocation of a 
tag that defines the symbol. 


TAGFREEBA, at tag or text, line 7, file 
file-spec 
Internal error. Attempt to free tag table entry with bad address 


Fatal: The tag translator’s memory allocation algorithm has failed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


TAGINFILE, The tag was in the file filename 


Informational: This message may accompany a message indicating that 
a tag that must be ended was not terminated. This message is output 
when the starting tag is not in the current input file. 


User Action: Use the file spec given to determine which file contains the 
tag that was not properly terminated and terminate it. 


TAGINVALD, at tag or text, line n, file 
file-spec 
Tag <tagname> is invalid in this context. 
The context was established by <tagname> on line number of 
filename 


Error: A tag was specified in a context where it is not valid, for example, 
a header-level tag was specified within the context of a monospaced 
example. The message tells you what tag established the context. 


User Action: Determine the current context at the point at which 
the message was issued to determine if you have forgotten a required 
terminator and correct your source file. 
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TAGINZONE, at tag or text, line n, file 
file-spec 
Tag <tagname> is invalid in the bounds of string. 


Error: A tag was specified in a context where it is not valid, for example, 
a header-level tag was specified within the context of a monospaced 
example. 


User Action: Determine the current context at the point at which 
the message was issued to determine if you have forgotten a required 
terminator and correct your source file. 


TAGNOTDEF, at tag or text, line n, file 
file-spec 
Tag <tagname> is undefined 


Warning: A tag has been invoked, but no definition exists for the tag. 
This message appears for the first invocation of an undefined tag. 
Subsequent invocations of the same undefined tag are counted, but the 
message is not repeated. A count of the total number of all invocations of 
undefined tags is reported at the end of the tag translator’s processing. 


User Action: Correct the spelling of the tag or supply a definition for the 
tag. . 


TAGNOTEND, at tag or text, line n, file 
file-spec 
Tag <tagname> from line number not terminated 


Error: A tag that has a required terminator was not terminated. 


User Action: Locate the tag that was not terminated and include its 
terminating tag at the appropriate position in your source file. 


TAGNOTHID, at tag or text, line n, file 
file-spec 
Cannot reveal tag <tagname>. It is not hidden 


Warning: A <REVEAL_TAGS> tag is requesting that a hidden tag be 
revealed, but the tag is not currently hidden. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


TAGNOTPRE, at tag or text, line n, file 
file-spec 
Tag <tagname> invalid unless preceded by string 


Warning: A tag is being invoked that is invalid because it is being used 
out of context. 


User Action: Check the sequence of tags to ensure that the proper 
context is established before the tag is used. Correct the SDML source file. 
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TAGNOTPRX, at tag or text, line n, file 
file-spec 
Tag <tagname> invalid unless preceded by an example tag 


Warning: A tag is being invoked that is invalid because it is not being 
used within an example. 


User Action: Check the sequence of tags to ensure that an example tag is 
used before the <VALID_BREAK> tag. Correct the SDML source file. 
TAG_FAILS, The tag translator has detected a fatal error 


Error: The tag translator is terminating execution with failure status. 
The accompanying error message supplies details of the error. 


User Action: See the description of the accompanying error message. 


TAG_IDENT, message 


Informational: This message will appear only in patched or baselevel 
systems. The tag translator inserts the text, which is usually some kind of 
internal baselevel indicator. 


User Action: None. 


TAG_INARG, at tag or text, line n, file 
file-spec 
<tagname> is invalid in an argument to <tagname>. 


Fatal: The indicated tag was specified in an argument to a tag that does 
not allow it. For example, a header level tag was specified in an argument 
to <TABLE_ROW>. 


User Action: Verify that you correctly terminated the argument list for 
the tag in which this tag was specified. 


TBLATTIGN, at tag or text, line n, file 
file-spec 
<TABLE_ATTRIBUTES> specified following <TABLE_SETUP> ignored. 
Warning: The <TABLE_ATTRIBUTES> tag must be specified preceding the 
<TABLE_SETUP> tag. The specified attributes will be ignored. 


User Action: Move the <TABLE_ATTRIBUTES> tag in front of the <TABLE_ 
SETUP> tag. 


TBLATTRIB, at tag or text, line n, file 
file-spec 
Argument string to tag <tagname> is not a valid table attribute 
Warning: A keyword was specified in a <TABLE_ATTRIBUTES> tag that is 
not a valid keyword attribute for tables. 


User Action: Verify that the specified value is a valid table attribute and 
check its spelling. Correct the SDML source file. 
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TBLBRKCOL, at tag or text, line 7, file 
file-spec 
Table cannot be broken in column number 


Warning: The <VALID_TABLE_ROW_BREAK> tag is valid only in columns two 
through four of a table. 


User Action: Remove the <VALID_TABLE_ROW_BREAK> tag. If the text in 
column is too long for a page, consider restructuring the table to be less 
complex. 


TBLCOLCNT, at tag or text, line n, file 
file-spec 
Tag <TABLE_SETUP> argument 1 string is missing or is not a 
number in the range 2 through 9 


Error: The <TABLE_SETUP> tag must specify a numeric value in the range 
of 2 through 9 to specify the number of columns in the table. The indicated 
argument is invalid. 


User Action: Correct the <TABLE_SETUP> tag. 


TBLCOLNUM, at tag or text, line n, file 
file-spec . 
Table column size argument string is missing or is not numeric 


Error: An argument specified as a width for table rows in setting up the 
table is not a numeric argument. 


User Action: Correct the <TABLE_SETUP> tag that specifies a non-numeric 
value for a table column width. 


TBLCOLWID, at tag or text, line n, file 
file-spec 
Sum of table column widths number is too large or is 0 or less. 


Error: The sum of the values specified for the column widths in the 
<TABLE_SETUP> tag is excessive or is less than or equal to 0. The message 
displays the current summed value of all column widths specified. 


User Action: Verify that the numbers you specified in <TABLE_SETUP> 
are accurate. Adjust them to smaller numbers so that the table will 

fit. If you did not specify <TABLE_ATTRIBUTES>(WIDE) and the doctype 
you are using provides an extra margin for wide tables, specify <TABLE_ 
ATTRIBUTES>(WIDE) in front of the <TABLE_SETUP> tag. To request that the 
table appear in a smaller typesize, use <TABLE_ATTRIBUTES>(MAXIMUM). 


TBLDUPSET, at tag or text, line n, file 
file-spec 
Tag <TABLE_SETUP> specified twice. Duplicate setup ignored. 


Warning: A table contains two <TABLE_SETUP> tags. The second tag is 
being ignored. 


User Action: Determine which <TABLE_SETUP> tag is correct and remove 
the extra one. 
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TBLFNOTEM, at tag or text, line 7, file 
file-spec 
Table footnote number number exceeds maximum number 


Warning: A numeric argument specified for a footnote declaration in a 
table exceeds the maximum. The maximum number of table footnotes 
is normally 12; however, if you use any non-numeric keywords in table 
footnotes, the maximum number allowed is reduced to 6. 


User Action: Verify the number of footnotes in the table and the numeric 
arguments you use to declare and reference them. 


TBLKEYDUP, at tag or text, line n, file 
file-spec 
Table already specifies <TABLE_KEY>. Duplicate ignored. 


Warning: Only one key can be specified in a table. The second key 
specified is being ignored. 


User Action: Determine which table key is the one that you want and 
remove the extra one. 


TBLKEYNES, at tag or text, line n, file 
file-spec 
<tagname> is not valid in a nested table. 
Nested table on line number in file string. 


Warning: A <TABLE_KEY> or <TABLE_KEYREF> tag was specified in a nested 
table, that is, in a table that is specified in another table’s <TABLE_ROW>. 
Table keys and table key references are invalid in nested tables. 


User Action: Place the table key and/or the reference to it in the outer 
table. 


TBLKEYNUM, at tag or text, line n, file 
file-spec 
The <TABLE_KEY> tag will replace table footnote 12. 
Warning: When a key is specified in a table, you cannot specify a table 
footnote numbered 12. The text of the table key will replace the footnote 
number 12, and references to footnote 12 will be result in the table key 
being printed. 


User Action: Check the arguments you specified to the <FOOTNOTE> tags 
in the table and do not specify a number greater than 11. 


TBLKNOREF, at tag or text, line n, file 
file-spec 
Tag <TABLE_KEYREF> tag encountered in a table that has no 
key. 


Warning: A <TABLE_KEYREF> tag is not valid because there is no key in 
the table to reference. 


User Action: Verify that the <TABLE_KEY> tag is correctly specified in the 
main table (it must not be specified in a nested table). If the table has no 
key, remove the <TABLE_KEY> tag. 
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TBLNBREAK, at tag or text, line n, file 
file-spec 
A nested table with more than three columns cannot be broken. 


Error: The <NESTED_TABLE_BREAK> was specified in a nested table that 
has more than three columns. 


User Action: Verify that the <TABLE_SETUP> tag for the table you are 
trying to break was correctly specified. If the nested table has four 
columns, you may need to restructure your information. 


TBLNONEST, at tag or text, line n, file 
file-spec 
Invalid table nesting. Ignored 


Warning: You coded a nested table incorrectly. There are three possible 
problems: 


1 You specified a <TABLE> tag with a caption argument in an argument 
to a <TABLE_ROW> tag. You cannot place a formal table inside another 
formal table. 


2 You specified a <TABLE> tag inside another table, but outside of a 
<TABLE_ROW> tag. All text (including nested tables) that occur within a 
table must be coded within <TABLE_ROW> tags. 


3 You specified a <TABLE_UNIT> tag inside a table that is nested in 
another table. <TABLE_UNIT> tags are not valid in nested tables. 
User Action: Based on the above situations, you should: 
1 Remove the caption argument from the nested table tag. 
2 Nest the table inside a <TABLE_ROW> tag. 
3 Remove the <TABLE_UNIT> tags. 
TBLNOROWS, at tag or text, line n, file 


file-spec 
A table was specified without any table rows. 


Error: <TABLE> and <ENDTABLE> tags were encountered in the file, but 
there were no <TABLE_ROW> tags between them. 


User Action: Verify that you specified <TABLE_ROW> tags correctly. Or, 
remove the <TABLE> and <ENDTABLE> tags if you did not want to place a 
table there. 


TBLNOTDEC, at tag or text, line n, file 
file-spec 
Table footnote number is referenced but not declared. 
- Warning: A <FOOTREF> tag is specified in a table, but there is no 


corresponding <FOOTNOTE> tag at the beginning of the table. The footnote 
reference will not be printed. 


User Action: Verify that you specified the <FOOTNOTE> tag correctly 
at the beginning of the table. Verify that the number specified in the 
declaration matches the number in the <FOOTREF> tag. 
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TBLNOTMTP, at tag or text, line n, file 
file-spec 
<tagname> invalid in table that is not multi-page 


Error: A tag, for example <TABLE_UNIT> was specified in a table that does 
not have the multipage attribute. 


User Action: Determine whether the table is a multipage table. If so, be 
sure that it is not specified with the KEEP attribute. 


TBLNOTROW, at tag or text, line 7, file 
file-spec 
Tag <tagname> specified outside of <TABLE_ROW>. 


Error: A tag is specified between two <TABLE_ROW> tags and is therefore 
not valid in this context.. 


User Action: Correct your source file to move the tags and related text, if 
any, to within the bounds of a <TABLE_ROW> tag. 


TBLNOTSET, at tag or text, line 7, file 
file-spec 
Table from line number has no <TABLE_SETUP> attributes. 


Error: A <TABLE_ROW> tag was encountered in a table without a 
<TABLE_SETUP> tag. 


User Action: Correct your source file to specify the number of columns 
and widths for the table. 


TBLNUMCOL, Table row column count does not match setup 


Informational: A tag, such as <TABLE_ROW> or <TABLE_HEADS>, specifies 
more or fewer arguments than indicated by the table setup. For example, 
a <TABLE_SETUP> tag indicates that a table has four columns, but a <TABLE_ 
ROW> tag specifies only three arguments. 


User Action: Determine whether you have not specified a column that is 
required, or whether you have correctly specified the <TABLE_SETUP> tag. 


TBLSPANNO, at tag or text, line n, file 
file-spec 
Argument number to tag <SPAN> is invalid for the current 
column count. 


Warning: A <SPAN> tag’s argument exceeded the number of remaining 
columns in the table. For example, you specified <SPAN>(3) in a table with 
only 2 columns. 


User Action: Correct your source file to specify the number of columns 
to span. Be sure that your numeric argument, plus the current column 
number, do not exceed the number of columns in the table. 
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TEXT _FORB, at tag or text, line n, file 
file-spec 
Text forbidden after <tagname> tag 


Warning: The <tagname> tag cannot be followed by a text segment. 


User Action: Correct your source file to remove the text that follows the 
tag or tag the text correctly. 


TEXT_NEST, at tag or text, line n, file 
file-spec 
Attempt to pop a text state that has not been pushed 


Error: A <SET_TEXT_STATE>(POP) tag is being invoked when there is no text 
state saved. 


User Action: Examine the tag definitions that contain the <SET_TEXT_ 
STATE>(POP) tag for a missing <SET_TEXT_STATE>(PERMITTED\ PUSH) tag. 


TEXT_REQD, at tag or text, line n, file 
file-spec 
Text missing after <tagname> tag 


Warning: The <tagname> tag marks a text segment, but the text is 
missing. 


User Action: Correct your source file to use the tag correctly. 


TMPNONEST, at tag or text, line n, file 
file-spec 
Invalid attempt to nest reference templates. 
Last template was string 


Error: A tag invoking a reference template was encountered when a 
reference template was already in effect; for example, a <ROUTINE_ 
SECTION> is specified before a previous <COMMAND_SECTION> was 
terminated. 


User Action: Correct your source file to correctly terminate the reference 
section that was not terminated. 


TMPTAGDEF, You cannot redefine <tagname> using <tagname>. 


Informational: A tag that defines a template tag specified a tag name 
that is already a defined tag. This message indicates one of the following: 


¢ Your input file has more than one reference template section, and you 
use the same template tag names in both. (For example, a 
<SET_TEMPLATE_ROUTINE> tag may specify the same tag name in more 
than one occurrence of <ROUTINE_SECTION>. 


¢ You have specified a name that is the name of an SDML global tag. 


User Action: If the message occurred because you used the same 
template tag names in more than one reference template section, you 
need take no action. If you have used a name that is the name of an 
SDML tag, you should select another name; future use of the SDML tag 
name in the same source file may produce unpredictable results. 
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TMPTAGEND, at tag or text, line n, file 
file-spec 
<tagname> not terminated before <tagname>. 


Warning: A tag occurring within the context of a reference template 
was not terminated before the end of the file or before the beginning 
of the next reference section. For example, an <OVERVIEW> tag from a 
<COMMAND> description was not terminated before the next <COMMAND> 
description was encountered. 


User Action: Correct the source file so that you correctly terminate the 
template tag. 


TMPTAGNAM, at tag or text, line n, file 
file-spec 
string is an invalid template tag name. 


Error: A template tag, for example <SET_TEMPLATE_COMMAND>, specifies 
that the tag name that already defined in SDML, or it is an invalid name, 
that is it contains more than 31 characters, or it contains nonalphanumeric 
characters. 


User Action: Choose another name for the tag and modify your source 
file. 


UNBALPARS, at tag or text, line n, file 
file-spec 
Unbalanced parentheses in argument number 


Warning: One or more left parentheses are present without matching 
right parentheses. A sufficient number of right parentheses are appended 
to the argument to achieve a balance. 


User Action: Correct the unbalance either by adding the proper number 
of right parentheses or by coding the left parentheses using the <OPAREN> 
tag. 


UNDEFSYMS, There were number undefined symbol references 


Informational: Reports the total number of references that were made to 
undefined symbols. Only the first reference to a specific undefined symbol 
is reported. 


User Action: Either define the undefined symbol or correct the spelling 
of the symbols being referenced. The ee symbols were reported in 
other messages. 


UNDEFTAGS, There were number undefined tag invocations 


Informational: Reports the total number of invocations of undefined 
tags. Only the first invocation of a specific undefined tag is reported. 


User Action: Either define the undefined tags or correct the spelling 
of the tag being invoked. The undefined tags were reported in other 
messages. 
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UPDATINFO, Update page label string, <tagname> 


Informational: A document that is being processed to produce update 
pages may have associated update information. The information indicated 
will be printed on the bottom of each page output. 


User Action: Verify that the update page label is correct for your 
document. 
USEDEFINC, Using a value that is one greater than previous value 


Informational: Accompanies other warning messages. It indicates that a 
default value is being used that is one greater than a previous value. 


User Action: Edit the SDML source file to correct the argument. 


USENODLIM, Using no delimiters 


Informational: Accompanies other warning messages. It indicates that a 
stacked list will be output without delimiters. 


User Action: Edit the SDML source file to correct the argument. 
USER_IMSG, | string | 
Line is number of file filename 


Informational: This message code is used for messages written to the 
terminal or output stream when a <USER_I_MESSAGE> tag is specified in the 
input file. 


User Action: The action you take depends on the content of the user’s 
message. 


USER_WMSG, at tag or text, line 7, file 
file-spec 
string 


Warning: This message code is used for messages written to the terminal 
or output stream when a <USER_W_MESSAGE> tag is specified in the input 
file. 


User Action: The action you take depends on the content of the user’s 
message. 
USESPCOUT, Alignment characters will be output as spaces 


Informational: Accompanies other warning messages. It indicates that a 
default value of space will be used as output for the alignment character. 


User Action: Edit the SDML source file to correct the argument. 


USETAGDEF, Using tag’s default: number 


Informational: Accompanies other warning messages. It generally 
indicates that a default value is being taken. 


User Action: Edit the SDML source file to correct the argument. 
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VBARINARG, at tag or text, line n, file 


file-spec 

A vertical bar was found in argument number to tag 
<tagname>. 

Use the <VBAR> tag to code a vertical bar in an argument 


Fatal: The tag translator treats the vertical bar character as a special 
operator character in arguments to tags. If you include a vertical bar 
character in an argument, the tag translator may overlook the right 
parenthesis that terminates the argument list, and may scan all of the 
remaining input looking for the proper terminator. 


If you have mistakenly omitted the closing parenthesis of an argument 
list, the tag translator begins to search the remainder of your file for a 
closing parenthesis. If it encounters a vertical bar (perhaps in a figure 
or code example), it then begins to search for a matching ampersand. 


Thus, this error message may be issued instead of the EOFARGLST error 


message. 


User Action: Correct the argument list by replacing the vertical bar with 


the <VBAR> tag or by properly closing the argument list. 


VMOVRFLOW, at tag or text, line n, file 


file-spec 
Internal error. Failure to allocate additional space in virtual 
memory 


Fatal: This error message is generally caused by one of two types of error 


in the SDML file. These errors, and the action that you should take to 
correct them, are as follows: 


e An unterminated argument list. If you fail to terminate an argument 


list, the tag translator regards the text that follows the argument list 
as part of the last argument. Suppose you write 


<EMPHASIS>(always\BOLD> press the RETURN key. 
instead of 


<EMPHASIS>(always\BOLD) press the RETURN key. 


The tag translator does not realize that the right angle bracket should 


have been a right parenthesis. It tries to include all the following 
words as part of the second argument of the <EMPHASIS> tag. This 
means that it may store large portions of the SDML file in memory 
while it searches for a closing parenthesis to the argument list. If 
memory limits are exceeded, the VMOVRFLOW error message is 
issued. 


¢ Too many tag definitions. The tag translator has no limit on the 


number of tag definitions. However, a limit is imposed by the memory 


allocation algorithm. When this limit is exceeded, it usually indicates 
that one or both of the following conditions are present: 
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¢ A file that contains tag definitions is being repeatedly included. 
This file is often a global definitions file that is being used to 
define tags or symbols for text substitution. You can avoid memory 
limitation problems by using the <CHECK_FOR_INCLUSION> tag at 
the start of such a file. This ensures that the file’s definitions are 
actually loaded only once, even though the file is included many 
times. 


¢ A tag’s definition changes frequently during execution, perhaps 
when the tag is being used to temporarily hold a text string. If the 
tag’s definition is established each time by the <DEFINE> tag rather 
than by the <REDEFINE> tag, the definitions pile up in memory. A 
reference to the tag always retrieves the latest definition, and if 
you never use the <UNDEFINE> tag to erase the latest definition, 
you will never see the old definitions, but they are still occupying 
memory space. 


User Action: Determine if the error was caused by an unclosed argument 
list. The error is generally located by the information supplied in the error 
message. 


Otherwise, examine your tag definitions to determine whether you are 
defining the same tag name multiple times. You can avoid memory 
limitation problems by defining your tags with the <REDEFINE> tag, rather 
than with the <DEFINE> tag. Unless you specifically intend to “stack” tag 
definitions, and use the <UNDEFINE> tag to “pop” definitions off the stack, 
you should always establish a tag definition with the <REDEFINE> tag. 


XRFINCMPL, at tag or text, line n, file 
file-spec 
The file containing cross reference symbols is incomplete. 
filename 


Fatal: During the reading of the file containing cross reference symbols, 
an error was detected that indicates that the file was not recorded 
correctly. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


XRFINVALD, at tag or text, line n, file 
file-spec 
The file containing cross reference symbols is invalid. 
filename 


Fatal: The file was opened without error, but it does not contain cross 
reference symbols. 


User Action: The wrong file is being referenced. Check the file name 
supplied with the /PROFILE qualifier. 
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XRFNORENM, at tag or text, line n, file 
file-spec 
The temporary cross reference file cannot be renamed to 
filename 


Fatal: The tag translator creates a temporary cross reference file with 
a file type TMP. When the file is complete, it renames it with a file type 
XREF. The rename operation has failed. 


(You must have Delete privileges for the directory in which the TMP file is 
being renamed.) 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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B.3 Text Processor Messages 
ATPT, Font was read at number pt 
Informational: This is an internal error. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADALPHA, Improper alphabetic constant 


Warning: Text formatter expected to scan a constant consisting only of 
_ letters. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADCHAR, Text line contains an invalid character 


Warning: Text formatter could not scan a character from the current 
input line. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADCODE, Bad code number: value, must be between smaller number and 
larger number 
using zero instead 


Warning: Text formatter expected to find a code value within the range 
shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADCS, Bad control sequence: Command 


Warning: Text formatter could not understand how the user meant to use 
the shown command in the current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADDISC, Improper discretionary list. Must contain only 
kerns and boxes 


Warning: Discretionary list contained unexpected information. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADDISCMATH, Illegal discretionary break in math mode. 
The third part of a discretionary break must be empty 
in this mode. Attempting to recover... 


Warning: Discretionary break was improperly coded. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADDUMP, Cannot \dump inside a group 


Warning: Command \dump occurred when there was one group or more 
still active. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADFONTFMT, Fatal font format file error 


Error: Text formatter could not load the font format file, or the font 
format file was fatally flawed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADFRACTION, Ambiguous fraction ignored. 
Warning: Text formatter could not determine the meaning of a fraction. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADGLUE, Infinite glue. Attempting to recover 


Warning: Text formatter was asked to typeset a box using infinite glue. 
Glue was made finite and the text formatter attempted to continue. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADHALIGN, Improper \halign 
Warning: Command \halign is invalid in current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADHRULE, Cannot use \hrule in an \hbox. 
Use \leaders or \hrulefill instead 


Warning: Command \hrule is invalid in current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADHYPHEN, Improper \hypenation ignored. 
Must contain only letters and hyphens 


Warning: Text formatter can only read letters and hyphens in a 
hyphnation pattern. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. | 


BADHYPHFMT, Fatal hyphenation format file error 


Error: Text formatter could not load the hyphenation format file, or the 
hyphenation format file was fatally flawed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADLASTBOX, \box255 is not empty, attempting to continue 
Warning: Text formatter expected \box255 to be empty. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADLEADERS, \ leaders not followed by proper glue 
Warning: Glue specifiaction was not valid in the current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADLETINPAT, Non-letter found in \ patterns 
Warning: Text formatter can only read letters in a pattern. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADLIMIT, Ignoring misplaced \limits or \nolimits command 


Warning: Text formatter did not expect to see \limits or \nolimits in this 
context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADMACROFMT, Fatal macro format file error 


Error: Text formatter could not load the macro format file, or the macro 
format file was fatally flawed. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADMAG, Illegal magnification ratio: bad number, value set to good number 


Warning: Text formatter could not set the magnification to the requested 
value. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADMATHCHAR, font number font-number is missing this character: 
character 


Warning: Text formatter could not typeset the character shown, because 
that character was missing from the font shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADMATHDELIM, Inserted missing or misplaced math delimiter 
Warning: Text formatter became confused while closing a math formula. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADNOALIGN, \noalign can only appear after \cr 
Warning: Command \noalign is not valid in the current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADOMIT, \omit can only appear after \cr or & 
Warning: Command \ omit is not valid in the current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. . 


BADOUTLOOP, Output loop repeated number of cycles times without doing a 
\shipout 
Attempting to recover. Increase \maxdeadcycles if neccesary 


Warning: Text formatter cycled through its output loop too many times 
without doing a \shipout. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADPARAMNUM, Illegal parameter number 


Warning: Text formatter became confused while scanning parameters to 
a macro. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

BADPARAMSEQ, Parameter was numbered out of sequence 


Warning: Text formatter became confused while scanning parameters to 
a macro, because a parameter was numbered out of sequence. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADPATTERNS, Bad \ patterns 
Warning: Text formatter became confused while reading a pattern. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADPREAMBLE, Cannot nest alignment preambles 


Error: Text formatter became confused during current alignment, because 
it found an alignment within an alignment. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADPREFIX2, Can’t use \long or \ outer with command 


Warning: Text formatter will ignore \long or \outer or \global when | 
used with the shown command. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADPREFIX8, Can’t use \long or \outer or \ global with command 


Warning: Text formatter will ignore \long or \outer when used with the 
shown command. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADPREVGRAF, \prevgraf = number. Value must be positive 


Warning: Text formatter expected to see \ prevgraf specified with a 
positive value. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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BADPT, Bad font size = number pt, replaced by 10 pt 


Warning: Text formatter attempted to read a font at an improper font 
size. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. ) 


BADUNBOX, Cannot unbox a hbox or vbox in Text formatter mode mode 
Warning: Command unbox is invalid under current circumstances. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADUNIT, Bad unit of measure, replaced by string 


Warning: Text formatter could not use the requested unit of measure. 
Unit was changed to shown value. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BADVALUE, quantity = quantity. Value must be between smaller number and 
larger number 


Warning: Text formatter was expecting to read a value within the range 
shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


BUFFERSIZE, Maximum number of characters in the input buffer is number 


Informational: User has exceeded total size of text formatter’s input 
buffer. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


CANNOTRESETMAG, Cannot change magnification, using old value: number 
Warning: Text formatter can only set magnification value once. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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CONFUSION, Text formatter became confused doing this: Command, 
job is aborting 


Error: Text formatter became confused doing the shown activity and had 
to exit. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DIMENTOOBIG, Dimension too large 


Warning: Text formatter became confused while scanning a dimension, 
because the dimension was too big. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DISCTOOLONG, Discretionary list is too long. Attempting to recover 
Warning: Discretionary list was too long. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DOUBLESUB, Double subscript 


Warning: Text formatter found a quantity with two subscripts. In these 
cases, x142 will be treated like x41 {}42. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DOUBLESUPER, Double superscript 


Warning: Text formatter found a quantity with two superscripts. In these 
cases, x_l_2 will be treated like x_1{}_2. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

DURING, Error occurred during a command 
Warning: Error occurred during a specified command or control sequence. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


DURINGOR, Error occurred during a command or string 


Warning: Error occurred during one of the two commands or control 
sequences shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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EMERGENCYSTOP, Job is aborting 


Error: Text formatter became confused and had to exit. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ENDDURING, \end occurred during command 


Warning: Command \end occurred unexpectedly. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ENDINGROUP, \end occurred inside group at level Number 


Warning: Command \end occurred when there was one group or more 
still active. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


EOF, Unexpected end of file 


Warning: Text formatter encountered the end of the current file 
unexpectedly. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


EOP, Paragraph ended before the following completed: 


Warning: Text formatter encountered the end of a paragraph 
unexpectedly. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


EXTRATAB, Extra \halign or & in alignment has been changed to \cr 


Warning: Text formatter found extra or unexpected \halign or &. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


FILENAME, file-name 


Informational: Identifies current file being used as input. 


User Action: This message always occurs in conjunction with other 
messages. Action depends upon associated message. 
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FONTDIMEN, The following font has only number fontdimen parameters 
To increase the number of font parameters you must use 
\fontdimen immediately after the \ font is loaded 


Warning: Current font has too many parameters. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


FONTERROR, Error occurred in the following font: 
Warning: Text formatter found an error in the current font. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


FONTMEMSIZE, Font memory size = number words 
Informational: Reports the total size of text formatter’s font memory. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


FONTTYPE, Font was declared by: string 
Warning: Identifies the font’s type, e.g. \ preloaded. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


FUNNYCS, Missing control sequence inserted 


Warning: Text formatter became confused while defining a control 
sequence. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


HPOOLSIZE, Hyphenation string memory size = number bytes 


Informational: User has exceeded total size of text formatter’s 
hyphenation string memory. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


IDENT, string 
Informational: Identifies the current version of the text formatter. 


User Action: None. 
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IGNORED, Extra command ignored 
Warning: An unneccesary text formatting command was found. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


IGNOREDTEXT, All text was ignored after line string 


Warning: Text formatter could not typeset any of the following lines 
shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


IGNORING, Ignored the following: command 


Warning: Text formatter encountered an unexpected command and 
ignored it.) 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


IMPROPERCMD, Improper command found: command 
Warning: command shown is not valid in the current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INCOMPLETECMD, Incomplete command found: command 


Warning: Text formatter became confused while trying to scan the shown 
command. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INFO, text - on page number 


Informational: A text formatting macro has generated an informational 
message. A problem occurred while the text formatter was processing the 
output. zext provides a description of the problem. In most cases, the file 
will continue processing successfully and you can examine the output. The 
message indicates the page on which the problem occurred, and you can 
use this information to correct the problem 


User Action: The following is a list of the messages you may see and the 
associated action that will correct the problem. 


¢ Callout number 0 is undefined. Using 1. 


You specified a <CALLOUT> or <CO> tag as 0. 


Messages 
Text Processor Messages 


Callout number exceeds 99. Using 99. 


A <CALLOUT> or <CO> tag’s value is greater than 99. POSTSCRIPT 
output devices cannot print numbers greater than 99. 


Error in setting note type; using default. 


A local or personal DESIGN file specified an invalid value for the 
\noteformattype. Refer to VAX DOCUMENT Designing Doctypes for 
value values. 


Error. Maximum number of table footnotes exceeded. 


You specified too many <FOOTNOTE> tags for a table. The largest 
number that is allowed is 12. 


Error pushing/popping revision bars. 


<MARK> and <ENDMARK> tags are not evenly matched or are not 
suppressed around heading levels in the correct sequence. If you 
receive this message and are under a service contract with Digital, 
call your customer service center. Otherwise, submit a Software 
Performance Report. 


Possible problem in the output of revision bars. 


The text formatter encountered a complex situation while a revision 
mark (from the <MARK> tag) was active. Examine your output closely 
to determine if the revision mark output is correct. A revision mark 
may not appear or it may appear where you did not intend it to. If 
there is a problem, you can change your source file to decrease the 
range in which a revision mark is active. For example, if you have 
changes in two rows of a table, you might place the <MARK> and 
<ENDMARK> tags inside each of the two <TABLE_ROW> tags instead of 
around the entire table. 


Figure is too large for a single page. 


A value specified in <FIGURE_SPACE> or <FIGURE_FILE> exceeds the 
depth of the output page. The text formatter uses only the depth of 
the page. 


Correct the invalid depth argument in the SDML file. 
The <FOOTREF> tag before the <FOOTNOTE> tag in the table is ignored. 


A tag <FOOTREF> tag occurs in a table for which no corresponding 
<FOOTNOTE> tag occurs. You must specify footnotes in tables at the 
beginning of the table, before any references to them occur. 


Graphics files cannot be included on this device. 


A <FIGURE_FILE> or <ICON_FILE> tag was encountered that specified 
a graphics file to be included on a device that does not support the 
inclusion of graphics. The tag is ignored. 


An index subentry is more than 4 levels deep; it is ignored. 


An indexing tag (<X> or <Y>) contains more than four <XSUBENTRY> 
tags. Only four levels of subentry are allowed. 


Correct the indexing tag by removing the excessive subentries. 
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Included files are not allowed to float. 


An included text formatter file in a figure is assumed to be multipage 
and cannot float. 


Remove the FLOAT attribute. 

Internal error while processing a table. 

The text formatter received bad input. Submit an SPR. 
Invalid table of contents entry. 


A local or personal doctype specified an invalid value for a table of 
contents entry. Correct the table of contents entry to use a valid code. 


If this error occurs using a standard VAX DOCUMENT design, submit 
an SPR. 


Monospaced example is too big to keep. 


You specified the keyword KEEP as an attribute to a <CODE_EXAMPLE> 
tag or other tag that specifies a monospaced example. The number of 
lines in the example cannot fit on a single page of output. 


Remove the keyword KEEP from the tag and provide <VALID_BREAK> 
tags to indicate acceptable page break points. 


A multipage figure is not allowed to float. 


You specified a figure with both the attributes FLOAT and 
MULTIPAGE. Multipage figures cannot float; the text processor 
outputs it at the location of its occurrence in the source file. 


Remove the FLOAT attribute. 
There is no template heading defined at this level; using level two. 
A <PAGE> tag is ignored in a floating figure. 


A <PAGE> or <FINAL_CLEANUP>(PAGE) tag is encountered in a figure that 
has the default attribute FLOAT. 


Specify <FIGURE_ATTRIBUTES>(MULTIPAGE) for all figures that are more 
than a page in length. 


A <PAGE> tag is ignored in taa ble that is not multipage. 


A <PAGE> or <FINAL_CLEANUP>(PAGE) tag is encountered in a table that 
has the default attribute FLOAT. 


Specify <TABLE_ATTRIBUTES>(MULTIPAGE) for all tables that are more 
than a page in length. 


Possible table paging problem. 


A table that is output on more than one page is being forced to break 
across pages without explicit page breaking or sufficient valid table 
break points. 


In most cases, the output is acceptable. The text formatter makes 
its best decision about breaking tables across pages when there are 
<TABLE_ROW_BREAK> tags to specify the first and last valid breaks for 
the table. 


Messages 
Text Processor Messages 


Revision bars cannot be output on this device. 


<REVISION>, <MARK>, and <ENDMARK> tags cannot be processed for this 
device. No change bars are printed. 


A <SPAN> tag at the end of a table column is ignored. 


The <SPAN> tag, which specifies that text is to span 2 or more columns 
in a table, must precede the text in the argument. For example, 


<TABLE _ROW>(<SPAN>(3)This text sits across all three columns) 
Move the <SPAN> tag to the beginning of the tag’s argument. 
The table is too wide for the page. 


The values you specify in the <TABLE_SETUP> tag result in a table that 
does not fit on the current page. Check the arguments you specified 
to the <TABLE_SETUP> tag and decrease them. You are able to tell from 
the output how much of the table is excessive. 


A <TABLE_HEADS> tag preceding a <TABLE_SETUP> tag is ignored. 


You must specify table headings following the <TABLE_SETUP> tag. 
Move the <TABLE_HEADS> tag so that it precedes the <TABLE_SETUP> 
tag. 


A <TABLE_HEADS> tag within a <TABLE_UNIT> tag is ignored. 


Do not use the <TABLE_HEADS> tag inside <TABLE_UNIT> tag sequences; 
use the <TABLE_UNIT_HEADS> tag instead. 


A <TABLE_ROW> tag is encountered outside of a <TABLE> tag. 


You specify a <TABLE_ROW> tag, but there is no <TABLE> tag. The tag is 
ignored. Correct the file so that a valid <TABLE> tag precedes it. 


<TABLE_ROW_BREAK> tags in a single-page table are ignored. 


You specify the <TABLE_LROW_BREAK> tag in a table that has the 
attribute KEEP. 


Remove the KEEP attribute from the table or remove the 
<TABLE_ROW_BREAK> tag. 


A <TABLE_UNIT_HEADS> tag outside of the table unit ignored. 


A <TABLE_UNIT_HEADS> tag is encountered before a <TABLE_UNIT> tag to 
begin a table unit. 


Remove the tag or insert a <TABLE_UNIT> tag to enclose a table unit. 
Tracing is disabled in VAX DOCUMENT. 


An instruction to accumulate tracing information occurred in a TEX 
file. VAX DOCUMENT does not support these instructions. 


Too many columns specified for multi-column output. 
A local or personal doctype specifies too many columns of output. 


If this error occurs using a standard doctype, submit an SPR. 
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INITEXPAT, \patterns can only be used by Initex 


Warning: Text formatter only recognizes \ patterns when it is building 
format files, not during a run of VAX DOCUMENT. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INSERTED, Missing command inserted 
Warning: Missing command was inserted into the input stream. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INSERTHBOX, \insert can only be added to a \vbox 
Warning: Command \insert is not valid in the current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INSERTING, Inserting command 


Warning: Text formatter attempted to resolve an unexpected situation by 
inserting shown command into the input stream. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INSUFEXTFON, Math formula deleted: Insufficient extension fonts 


Warning: Math formula could not be typeset because extension fonts were 
inadequate or missing. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INSUFSYMFON, Math formula deleted: Insufficient symbol fonts 


Warning: Math formula could not be typeset because symbol fonts were 
inadequate or missing. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


INTERNALERROR, Internal error number: error number. Job is aborting 
Error: Text formatter found an internal inconsistency. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


Messages 
Text Processor Messages 


LINE, Error occurred on or around line number: number 


Informational: Reports the current line of input that the text formatter 
is processing. 


User Action: This message always occurs in conjuction with other 
messages. Action depends upon associated message. 


LINETOOLONG, Line too long by Integer.remainder points 
Informational: The text formatter found a very lengthy line. 


User Action: This message always occurs in conjuction with other 
messages. Action depends upon associated message. 


LINETOOSHORT, Line too short - on page Page number 
Informational: The text formatter found a line that was too short. 


User Action: This message always occurs in conjuction with other 
messages. Action depends upon associated message. 


MATHOVERFLOW, Arithmetic overflow 
Warning: Result of a mathematical operation was too large. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXFONTS, Maximum number of fonts is: number 
Informational: User has exceeded maximum number of fonts. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MAXGROUPS, Maximum number of groups is: number 
Informational: User has exceeded maximum number of groups. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXHASH, Maximum number of entries in hash table is: number 


Informational: User has exceeded maximum number of entries on text 
formatter’s hash table. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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MAXHSTRINGS, Maximum number of hyphenation strings is: number 


Informational: User has exceeded the maximum number of hyphenation 
strings. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXHYPHS, Number of hyphenation exceptions is: number 


Informational: User has exceeded maximum number of hyphenations. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXINPUTS, Maximum number of simultaneous input files is: number 


Informational: User has exceeded maximum number of simultaneous 
input files. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXNESTS, Maximum number of simultaneous semantic levels is number 


Informational: User has exceeded maximum number of simultaneous 
semantic levels in text formatter. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXPARAMS, Maximum number of simultaneous text macro parameters is 
number 


Informational: User has exceeded maximum number of parameters to a 
macro. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXSAVE, Maximum number of entries on save stack is: number 


Informational: User has exceeded maximum number of entries on text 
formatter’s save stack. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MAXSTRINGS, Maximum number of strings is: number 
Informational: User has exceeded maximum number of strings. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


Messages 
Text Processor Messages 


MEMORYSIZE, Main memory size = number words 


Informational: User has exceeded the total size of the text formatter’s 
main memory. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MESSAGE, text - on page number 


Warning: Text formatter macro generated a warning message. The 
following is a list of possible messages and actions. 


User Action: See the action associated with each of the following 
messages. 


e Error in the window size. 


An error occurred in a local or personal doctype; an invalid value was 
specified in a \ window. 


If this error occurs in a standard doctype, submit an SPR. 
¢ Internal error in setting block indents. | 


Too many arguments are specified to \ blockindents, or the values were 
not valid. This error should only occur if a local or personal DESIGN 
file contains an invalid value. 


e Internal error in figure key definition. 
Submit an SPR. 
¢ Too many floating figures. 


There are too many <FIGURE> tag sequences within a short span of 
text, and the default attribute “float” is in effect for all of them. 


The text formatter cannot produce meaningful output when there are 
too many figures that are floating. When you have a large number of 
figures in a short span of text, you should use the 
<FIGURE_ATTRIBUTES>(KEEP) tag to keep them in sequential order. 


¢ No room for a new [item]. 


Internal use. 


MISSINGBOOL, ’ or’=’ or’ 


Warning: Text formatter expected to scan one of the boolean values 
shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. Determine which boolean value is needed 
and insert it in the right place. 
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MISSINGLBRACE, Possible missing { 
Warning: Text formatter did not see an {. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


MISSINGRBRACE, Possible missing } 
Warning: Text formatter did not see an }. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

MODE, Error occurred in string mode 
Informational: Reports the current mode that the text formatter is in. 


User Action: This message always occurs in conjunction with other 
messages. Action depends upon associated message. 


MUERROR, Mismatched glue units. Assuming that 1mu=1pt 


Warning: Text formatter scanned glue specifications that are 
incompatible. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOBOX, Expected to find \hbox or \vbox or 
\copy or \box or something like that. 
Some text may be missing from output. 


Warning: Text formatter expected to find a box. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOEND, No \end was found 
Error: Text formatter expected to see an \end command. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOFONTID, Could not find font identifier for the following font: 
Warning: Font identifier for the current font is missing. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


Messages 
Text Processor Messages 


NOINPUTPAGE, no pages in input file 


Error: The input file named in an associated message contains no pages; 
therefore, there is no output to print. 


User Action: Check SDML source file to see why no text was found. 
NOINSLASTBOX, \insert255 is illegal. Changing to \insert0O 


Warning: Text formatter register \insert255 cannot be used in current 
context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOMATHACCENT, Changed \accent to \mathaccent 


Warning: The text formatter command \accent works differently in 
formulas than it does in normal text. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NONUMBER, Missing number, using zero 
Warning: Text formatter expected to find a number. 


User Action: If you receive this message and are under a service contract . 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOROOM, Exceeded memory capacity: 


Error: Text formatter exceeded one of its memory capacities. The message 
immediately following indicates which quantity was exceeded. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NOUSEAFTER, After this: command., the following is invalid: 


Warning: Text formatter cannot use the command shown in the next 
message directly after the command shown in this message. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


NUMBERTOOBIG, Number too large, using 2147483647 instead 


Warning: Text formatter could not use specified number because it is too 
big. Text formatter used 2147483647 instead, which is the largest number 
possible in that context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 
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ONEOFFOUR, Some or all of the following 4 messages apply: 


Warning: One or more of the four messages that follow on your screen 
apply. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ONEOFTWO, One or both of the following messages apply: 


Warning: One or both of the two messages that follow on your screen 
apply. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


ONPAGE, on page number 
Informational: Identifies the current page being output. 


User Action: This message always occurs in counjunction with other 
messages. Action depends upon associated message. 


OUTFILENAME, file-name 
Informational: Identifies the output file name. 


User Action: None. 


PAGESOUT, number page(s) written. 
Informational: Reports the number of pages written to the output file. 


User Action: None. 


PAGETOOBIG, Cannot ship out huge page. More than 18 feet wide or long. 


Warning: Text formatter became confused during typesetting of current 
page because page was too large. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


PAGETOOLONG, Page too long by string.string points 


Warning: Text formatter could not fit the contents of the current page 
into boundaries of current page. Such errors are common with a line 
printer because it is monospaced. 


User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 


Messages 
Text Processor Messages 


PAGETOOSHORT, Page too short - on page Page number 


Informational: The text formatter had trouble composing the current 
page. There were not enough lines to reach the bottom. Such errors are 
common with a line printer because it is monospaced. 


User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 

PATTERNEXISTS, Duplicate pattern found 
Warning: Text formatter found a duplicate pattern. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 

PATTERNMEMSIZE, Hyphenation pattern memory size = number words 


Informational: User has exceeded total size of text formatter’s 
hyphenation memory. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


POOLSIZE, String memory size = number bytes 


Informational: User has exceeded total size of text formatter’s string 
memory. _ . 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


RUNAWAY, Runaway kind of text 


Warning: Text formatter became confused while scanning the shown kind 
of text. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. . 


SCALED, Font was scaled: number 
Informational: This is an internal error. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. . 

SHOWCONTEXT, text 


Informational: Displays the input stream that the text formatter was 
attempting to read when something went wrong. 


User Action: This message always occurs in conjunction with other 
messages. Action depends upon associated message. 
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SHOWTOKEN, text 


Informational: Displays part of text formatter’s current token list. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


TIGHTSPACING, Insufficient inter-word spacing - on page Page number 


Informational: The text formatter had trouble composing a line - there 
was not enough white space on the line. Such errors are common with a 
line printer because it is monospaced. 


User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 


TOOFEWLINES, Excess inter-line spacing - on page Page number 


Informational: The text formatter had trouble composing the current 
page. There was too much white space between the lines. Such errors are 
common with a line printer because it is monospaced. 


User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 


TOOMANYERRORS, Error limit is 30 


Error: Text formatter found more than 30 errors. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


TOOMANYLINES, Insufficient inter-word spacing - on page Page number 


Informational: The text formatter had trouble composing the current 
page. There was not enough white space between the lines. Such errors 
are common with a line printer because it is monospaced. 


User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 


TOOMANYPARAMS, More than nine parameters were passed to a macro 


Warning: Text formatter became confused while scanning parameters to 
a macro because there were too many paramters. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


Messages 
Text Processor Messages 


TRACE, text 


Informational: User has turned on text formatter’s tracing mechanism. 
Text contains information about VAX DOCUMENT?’s text formatter’s 
internals. 


User Action: None. 


UNDEFINEDCS, Undefined control sequence 
Warning: Text formatter encountered an undefined control sequence. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


UNKNOWNUNIT, Dimension unit must be: em,ex,in,pt,pc,em,mm,dd,cc,bp,sp 
Warning: Text formatter expected to read one of the dimensions shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


USINGZERO, Bad value, must be between smaller number and larger 
number, using zero instead 


Warning: Text formatter expected to scan a value in the range shown. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


VSPLITHBOX, Attempted to \vsplit a \hbox 
Warning: Command \vsplit is not valid in current context. 


User Action: If you receive this message and are under a service contract 
with Digital, call your customer service center. Otherwise, submit a 
Software Performance Report. 


WIDESPACING, Excess inter-word spacing - on page Page number 


Informational: The text formatter had trouble composing a line; there 
was too much white space on the line. Such errors are common with a line 
printer because it is monospaced. 


User Action: Examine the output on the page shown to determine if 
there is a problem with the coding of the SDML file. You can ignore the 
problem if it is not serious, or you can change destinations or change the 
doctype, if possible. 
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BADFILABORT, | file bad—aborting run 


Error: The device converter cannot use the font file named in an adjacent 
message. 


User Action: Another file may have been given the same name. Use the 
DIRECTORY/FULL DCL command to see that the size and format are 
similar to other font files. If necessary, reinstall the font data. 


BADFONT, font file bad—using blanks 


Warning: The file that describes the font design is unusable. The 
program will substitute blanks for the characters in this font. 


User Action: Use the DIRECTORY/FULL DCL command to see if the 
size and format of this file resembles other font files. If necessary, reinstall 
the font data. 


BADFONTSIZE, internal font error: font 
string scaled size out of range. 


Error: The device converter has detected a font size that is out of range. 
This may be a problem with the font file itself, or an internal device 
converter problem. 


User Action: None. 
BADINCDVI, bad file format or error in reading included DVI file 
filespec 


Error: The device converter has encountered a read error or illegal file 
format in an included DVI file. See the previous message. 


User Action: Regenerate the DVI file by running Document again. 


BADINCLUDE, included file is bad 


Warning: The program has encountered errors in processing the contents 
or index file requested. 


User Action: Check that previous processing steps generated the 
contents or index file expected, because the included file may be an old, 
incompatible file, it may be another file with the same name, or it may be 
the correct file made unreadable because of an I/O error. 


BADMETRIC, bad metric file 


Error: The device converter has encountered errors in processing the 
indicated font metric file. 


User Action: This may be another file named the same. Check the file 
size and format with the DIRECTORY/FULL DCL command to see if it 
resembles other font metric files. If necessary, reinstall the font data. 


Messages 
Device Converter Messages 


BADPAPERSIZE, illegal papersize string string, ignored 


Warning: An unsupported papersize string was encountered from the 
design file. 


User Action: Correct the design to specify one of the accepted papersizes. 


BADPOSTAMBLE, error in postamble of file 
string 


Error: The device converter encountered a read or file format error in the 
postamble of the named file. 


User Action: None. 


BADPOSTFORMAT, illegal postamble format 


Error: The device converter encountered a read or file format error in the 
postamble of the named file. | 


User Action: None. 


BADPREAMBLE, error in DVI file’s preamble. 
Error: The device converter cannot accept the DVI file’s preamble. 


User Action: Regenerate the DVI file by running Document again. 


BADPRIMDVI, bad file format or error reading primary DVI file: 
filespec 


Error: The device converter has encountered a read error or illegal file 
format in the primary DVI file. See the previous message. 


User Action: Regenerate the DVI file by running Document again. 
BADPXLFILE, bad file format or error in reading PXL bitmap font file 
filespec 


Error: The device converter encountered a read error or illegal file format 
in trying to read metrics or bitmap data for a PXL bitmap font. 


User Action: Reinstall the font data. 


BADSPECIAL, unknown DVI file special command code encountered. 


Error: The special command code read does not match any existing 
defined specials. 


User Action: None. 


BOOKABORT, aborting run—book string not created 


Error: The device converter received a fatal error; no DECW$BOOK file 
is made. 


User Action: Check the previous message to see what caused the fatal 
condition. : 
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BOOKBUILT, book was successfully built 
Informational: The book was completed without any fatal errors. 


User Action: None. 


CANNOTCONNECT, cannot connect along a diagonal 


Warning: While attempting to draw change bars, the program has 
encountered an attempt to draw a nonvertical line. Only vertical change 
bars are allowed. 


User Action: Look in the macros that describe change bar positioning for 
errors and inconsistencies. 


CANNOTCREATE, cannot create output file 
Error: The program cannot create an output file. 


User Action: Check that the output directory exists, that the user has 
permission to write in it, and that the device is available and is not full. 


CANNOTOPEN, cannot open input file 
Error: The program cannot open the input DVI file. 


User Action: Check that the input directory exists, that the file exists or 
was created by earlier processing steps, that the user has permission to 
read the file, and that the device is available. 


CANTCREATE, cannot create output file 
filespec 
Error: The device converter cannot open the named file for write. 


User Action: See next message. 


CANTOPEN, cannot open file 
filespec 


Error: The device converter was unable to open the named file. 


User Action: None. 


CONFIGERROR, error in configuration file 


Error: An error has been detected in reading the file that describes 
PostScript fonts. An adjacent error message gives more details. 


User Action: Check that the device is available and that the user has 
permission to read the file. Take the action suggested by the adjacent 
error message. If necessary, reinstall the font data. 


DIFPAPERSIZE, papersize in design but already specified on cmd line, 
using cmd line value string 


Warning: A papersize option was encountered both on the command line 
and in the design file. The command line value will be used. 


User Action: Specify the desired papersize in the design file. 
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DOCSETUP, error in generating document setup area. 


Error: The device converter experienced a fatal error while attempting 
to generate the document setup area, which contains all of the font 
definitions needed in the document. 


User Action: See adjacent messages. 
DVIEOF, premature end-of-file in DVI file 
filespec 


Error: The device converter encountered a premature end-of-file while 
reading the named DVI file. 


User Action: Regenerate the DVI file by running Document again. 


EXTNESTING, Extensions are being nested 
Informational: Extensions are being nested. 
User Action: This is not supported. Check the output carefully. 
HOTSPOTERR, HOTSPOT crosses Tex page boundary: 
string 


Informational: Gives the symbolic name of reference and the last chunk 
title that was defined. 


User Action: Using the symbolic name and the title locate the reference 
being broken up by the page break and insert an <ONLINE_CHUNK> tag 
before it. 
EXTNESTING, Extensions are being nested 
Informational: Extensions are being nested. 
User Action: This is not supported. Check the output carefully. 
HOTSPOTERR, HOTSPOT crosses Tex page boundary: 
string 


Informational: Gives the symbolic name of reference and the last chunk 
title that was defined. 


User Action: Using the symbolic name and the title locate the reference 
being broken up by the page break and insert an <ONLINE_CHUNK> tag 
before it. 


FCCANTOPEN, cannot open font configuration file 
filespec 


Error: The device converter was unable to open the named file. © 


User Action: None. 


FIGFILERR, Error encountered while reading: 
filespec 


‘Informational: An error was returned when reading the figure file. 


User Action: Check to make sure the figure is not corrupted. 
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FIGFILOPN, cannot open figure file 


Warning: The program cannot find the figure file named, or can find it 
but cannot open it. 


User Action: Check that you have specified the right filespec, that the file 
exists in the path specified (or in the current default directory, if no path 
is specified), that you have permission to read that file, and that the file is 
not locked by the action of some other program running at the same time. 


FIGNOTFND, cannot find figure image in figure file 


Warning: The figure file named in an adjacent message does not contain 
the proper codes to identify the type of figure expected. White space 
appears where the figure would be placed. 


User Action: Check the figure file. 


FILEI, error in reading file 
filespec 


Error: The device converter encountered an error while reading the 
named file. 


User Action: None. 


FILENESTING, one included file cannot include another file 
Warning: One contents or index file may not include another. 


User Action: Check the macros that describe contents and index files to 
see that they are correctly generating the filespecs. Check that the filespec 
generated for the contents or index file is the same as an existing file. 


FILEO, error in writing file 
filespec 


Error: The device converter encountered an error while writing to the 
named file. 


User Action: None. 


FNTCONFIG, description for font 
string missing or illegal in configuration file. 


Error: The specified font is not present, or not fully described, in the file 
that describes PostScript fonts. 


User Action: If necessary, reinstall the PostScript support. 


FNTFILEREF, font referenced in file 
filespec 


Error: The named DVI file contains a reference to the above font. 


User Action: None. 
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FONTCONFIG, Font description missing or illegal in configuration file 


Error: The specified font is not present, or not fully described, in the file 
that describes PostScript fonts. 


User Action: If necessary, reinstall the PostScript support. 


FONTERROR, error in font 
string 


Warning: An error has occurred while processing the named font. The 
specific problem is identified in an adjacent message. 


User Action: Note the name of the font. Take the action suggested by the 
adjacent error message. 


FONTTOOBIG, too many characters in font—limit is 188 
Error: The document uses too many characters from the named font. 


User Action: Reinstall the font files. If the problem persists, and if you 
are under a service contract with Digital, call your customer service center. 
Otherwise, submit a Software Performance Report. 


FSEEK, fseek internal error, file = 
string 


Error: The device converter encountered an internal error while 
attempting to fseek in the named file. 


User Action: None. 


IDENT, string 
Informational: Reports the version of the program in use. 


User Action: None. 


IGNORING, ignoring included input file 
filespec 


Warning: The program cannot process the included DVI file for the reason 
specified in an adjacent message. 


User Action: Note the name of the file. Take the action suggested by the 
adjacent error message. 


INCDVICANTOPEN, cannot open included DVI file 
filespec 


Warning: The device converter was unable to open the named file. 


User Action: None. 


INCLUDED, File filespec was successfully included 
Informational: The named file was succesfully read and stored 


User Action: None. 
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INCLUDING, including input file: 
filespec 


Informational: Reports that the program is processing a DVI file other 
than the file named on the command line. The file is typically a contents 
or index file. 


User Action: None. 


INITMEM, ran out of memory while initializing device converter 
Error: This memory error occured very early in the device conversion. 


User Action: None. 


INPUTBAD, bad input file—aborting run 


Error: The program has encountered errors in the named input file and 
cannot continue. 


User Action: Check the messages generated by earlier processing steps 
to see if a complete DVI file was created. 


INPUTFILE, input file is: 
filespec 


Informational: Reports the name of the primary DVI file, that is, the file 
named on the command line. 


User Action: None. 


INTERNALERROR, internal error 


' Error: A problem internal to the device converter prevents it from 
continuing. 


User Action: This sometimes represents a document so large or complex 
that it exceeds internal buffer sizes. Sometimes you can work around 
this by running contents and index processing as separate jobs, rather 
than including them in place. You may be able to process the document 
in two or more pieces by using the STARTING_PAGE and ENDING_ 
PAGE or NUMBER_OF_PAGES parameters to the device converter. If you 
receive this message and are under a service contract with Digital, call 
your customer service center. Otherwise, submit a Software Performance 
Report. 


INVALIDDATE, Invalid date specification. Use the dd-mm-yyyy format 
Error: The converter has found an invalid date specification. 


User Action: use the dd-mm-yyyy format to specify the date 
INVALIDOPTN, invalid option 


Error: This DVI special command contains an option not supported by 
this device converter, or the program cannot find an option at all. 


User Action: Check to see if you have requested a figure file, contents 
file, index file, change bars, or other function which is not supported for 
this destination; check for errors in the macros that generate this special 
command; check if the special has all required arguments 
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INVALIDPOINT, invalid point number number 


Warning: An error has occurred in the macros used to describe change 
bars. Specifically, an attempt has been made to locate a point off the page, 
or the point is incorrectly described. 


User Action: Look in the macros that describe change bar positioning for 
errors and inconsistencies. 


IN_CANTCLOSE, cannot close input file 
filespec 


Warning: Error in closing the file. Processing continues. 


User Action: None. 


NOCONTENTS, no contents file found - verify that 
1 - The command line has/CONTENTS specified 
2 - The document has a CONTENTS_FILE tag. 


Error: No contents file was processed, which causes a fatal error in 
bookbuilding for the Bookreader. 


User Action: Make sure there is a contents file and that it is included. 


NOFILABORT, cannot open file—aborting run 
Error: The device converter cannot open the named file. 
User Action: Check to see that the device is available, that the file exists, 
and that the user has privileges to access that file. 
NOFONT, cannot open font file—using blanks 
Warning: The device converter cannot open the named font file. 


User Action: Check that the device exists and is available, and that the 
user has permission to read the file. 


NOFONTDEF, no font defined for font select 
string 


Error: none. 


User Action: None. 


NOINCLUDE, cannot open included file 


Warning: The device converter cannot open the contents or index file 
named in the adjacent message. Either the pathname and filename are 
incorrect, or the program cannot gain access because of file protection or 
locking by another process. Processing will continue without this file. 


User Action: Check that the named file exists and that the user has 
access to it. 
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NOINPUTPAGE, no pages in input file 


Error: The input file named in an adjacent message contains no pages; 
therefore, there will be no output to print. 


User Action: Check to see if errors reported in earlier processes caused | 
there to be no pages generated. 


NOMETRIC, cannot open metric file 


Error: The font metric file named in an adjacent message does not exist, 
or the user does not have access to it because of file protection or problems 
with the device. 


User Action: Check that the file exists and is available, and that the 
user has access to it. Check that the user is specifying a DVI input file 
appropriate for the destination requested. 


NOSIXELIMAGE, cannot find sixel image in figure file 


Warning: The figure file named in an adjacent message does not contain 
the command sequence that identifies a sixel image. White space appears 
where the figure is expected. 


User Action: Check the figure file. For LN03 use, it must be a sixel file. 


NOSUBSTITUTE, no adequate alternate font found 


Error: The text formatter has requested a down-loaded font for which the 
device converter cannot find a reasonable substitute. 


User Action: Check the document design for the fonts used. Check that 
the corresponding font files exist at the sizes desired. 


NOSUCHUNIT, no such unit of measure 


Warning: A DVI special command used to position change bars or 
describe graphics files contains an unknown unit of measure, or no unit. 


User Action: Check the macros that describe change bar positioning or 
figure file characteristics for errors. 


OFFPAGE, cannot set text outside page boundaries 


Warning: An attempt has been made to set text outside the boundaries of 
the physical page specified. 


User Action: Check the messages from the text formatter for lines too 
long, that you specified a destination that can print a page as large as 
required by your design. Also, check to see if you specified a horizontal or 
vertical offset that will push your design off the page. 


ONPAGE, on page [string] 


Informational: Reports the number of the output page on which the 
condition reported in the associated messages occurred. 


User Action: Note this page number if you need to refer to the output. 
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OUTPUTFAIL, error writing to output file 


Error: The program encountered an error in writing to the output file. 
This usually means that the output disk is full, the user’s disk quota is 
exceeded, or the output disk has become unusable. 


User Action: Check that the output device is usable. If the disk is full or 
the user’s disk quota is used up, delete unwanted files and run the device 
converter again. 


OUT_CANTCLOSE, cannot close output file 
filespec 
Warning: Error in closing the file. Processing continues. 


User Action: None. 


PAGECOORDLOST, PAGE COORDINATION LOST string 
Error: The converter has found a page coordination problem. 


User Action: Make sure that two contents files are not being included 
and that there are no undefined symbols reported. 


PAGENOTFOUND, starting page not found 


Error: The user has specified a starting page number, but that page does 
not exist in the input file. 


User Action: Check the starting page specified and the input file 
specified. 


PAGESOUT, number page(s) written to file: 
filespec 


Informational: This reports the number of pages written to the output 
file named. 


User Action: No direct action needed; however, if the number is zero 
or less than expected, check other messages for errors or examine the 
commands, filespecs, options, and input files for problems. 


PAGETOOCOMPLEX, cannot hold all font data—using blanks 


Warning: The amount of font data required to describe all the characters 
on this page will not fit in the LNO3 font memory, so the characters in the 
current font will be represented as blanks. 


User Action: If using a design that allows you to change text_size, choose 
a smaller size, or use only one kind of emphasis on the page, if possible, or 
move portions of the text to adjacent pages. 


PASSIINCFNAMS, error on first pass through primary DVI file. 


Error: The device converter experienced a fatal error on its first pass 
through the primary DVI file in which it was attempting to generate a list 
of included filenames. 


User Action: See adjacent messages. 
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PFCANTOPEN, cannot open included ps plotfile 
filespec. 


Warning: The device converter was unable to open the named file. 


User Action: None. 


PLOTFILEFAIL, cannot open figure file 


Warning: The program cannot find the figure file named, or can find it 
but cannot open it. 


User Action: Check that you have specified the right filespec, that the 
file exists in the path specified (or current default directory, if no path is 
specified), that you have permission to read that file, and that the file is 
not locked by the action of some other program running at the same time. 


PRIMDVICANTOPEN, cannot open primary DVI file 
filespec 
Error: The device converter was unable to open the named file. 


User Action: None. 


PROLOGERROR, error in prolog file 


Error: The device converter cannot read its file that contains the 
PostScript prolog for output. 


User Action: Check that the device is available, that the file exists, and 
that the user has privileges to access the file. If necessary, reinstall the 
PostScript support. 

READFCMEM, ran out of memory while reading the font configuration file 


Error: This memory error occured early in the device conversion. 


User Action: None. 


SHELFBUILT, shelf was successfully built 
Informational: The shelf was completed without any fatal errors. 


User Action: None. 


SPECIALERROR, error in \special 
string 


Warning: This lists the text of a DVI special command as received by the 
device converter. This command is generated by macros, but may contain 
some user-specified information, such as a filespec or size. The specific 
problem associated with this special is described in an adjacent message. 


User Action: See the adjacent message for a description of the problem. 
If necessary, check this message for a filespec or size that may have been 
incorrectly entered in a tag describing a figure file, contents file, or index 
file. 
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SPECTOOLONG, \special too long—will try to process anyway 


Warning: This DVI special command exceeds the maximum length of 
1000 characters. The program will truncate the command and try to 
process it. 


User Action: Check the macros that generate this special command; 
they may be appending too many spaces or extraneous text following the 
command. 


TITLETOOLONG, Title has been truncated to 256 characters 
Informational: The chunk title is limited to 256 characters 


User Action: Use shorter titles that will fit in the window. 


TOLONG, device & directory spec too long cannot exceed 48 characters 
Error: the complete file spec is too long. 


User Action: Move the files to the directory where the device and 
directory specs total length is 48 characters or less. 


TOOMANYDVI, too many included input files 
Warning: Too many included contents or index files have been requested. 


User Action: Remove excess <CONTENTS_FILE> and <INDEX_FILE> tags 
from the input file. 


TOOMANYFONTS, too many fonts—limit is 100 
Error: The document contains too many fonts. 


User Action: Change the document design so it does not require so many 
fonts, or use SDML tags that do not require so many fonts, or break 

the document into separate documents, or process the contents or index 
separately. 


TOOMANYGLYPHS, too many glyphs used in all fonts combined 


Error: The document contains too many characters in too many fonts. 
The LNO3 cannot hold this many characters. 


User Action: Break the device conversion of this document into two or 
more jobs, specifying the starting page and ending page or number of 
pages. End one job before the page on which this error was reported. 


UNDEFSYM, | string 
Error: A reference to an undefined symbol was detected. 


User Action: Check that symbol names in references are legitimate. 
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UNRECOGOPTN, unrecognized option 


Warning: This DVI special command contains an option not supported by 
this device converter, or the program cannot find an option at all. 


User Action: Check to see if you have requested a figure file, contents 
file, index file, change bars, or other function that is not supported for 
this destination. Check for errors in the macros that generate this special 
command. 


VMBADFREE, Internal device converter error, failure to deallocate virtual 
memory 


Error: The device converter has failed while trying to deallocate virtual 
memory. 


User Action: Review any related informational messages, correct the 
problem, and reexecute the DOCUMENT command. If you are under a 
service contract with Digital, call your customer service center. Otherwise, 
submit a Software Performance Report. 


VMOVRFLOW, Internal device converter error, failure to allocate additional 
virtual memory 


Error: The device converter has failed while trying to allocate additional 
virtual memory. 


User Action: Review any related informational messages, correct the 
problem, and reexecute the DOCUMENT command. This error may be 
caused by the user having too small of a pagefile quota (PGFLQUO). If so, 
increase this value and reexecute the DOCUMENT command. If you are 
under a service contract with Digital, call your customer service center. 
Otherwise, submit a Software Performance Report. 
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B.5 Index Facility Messages 


BADATTR, illegal tag argument attribute list syntax in tag 
string. 


Error: A tag argument attribute list in the INX file contains illegal syntax 
or the INX file is corrupted. 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 


BADENTRYINCLUDE, warning: master, NOMASTER and BOTH on same 
entry for entry 
string 
using BOTH. 


Warning: The indexer has encountered an entry that contains MASTER, 
NOMASTER and BOTH entry inclusion attributes. It will convert this 
entry to be a BOTH entry. 


User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 


BADINXCHAR, Warning: illegal char/s after 
string, 
attempting to continue. 


Warning: The indexer has encountered one or more characters in between 
tags and tag arguments. The INX file may be corrupted. The indexer will 
ignore these characters and attempt to continue processing. 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 


BADTAG, unrecognized tag 
string 
Error: The indexer has encountered an unrecognized tag in reading the 
INX file. The INX file may be corrupted. 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact’ Digital. 


BEGINENDENTRY, warning: begin and end on same entry for entry 
string 
converting to a single page-number entry. 


Warning: The indexer has encountered an entry that contains both a 
begin and end page-range attribute. it will convert this entry to be a 
single page entry. 


User Action: Edit the SDML file and separate the begin-end page-range 
entries.. 
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BEGINONLY, begin page-range without end page-range for entry 
string, treating as single entry. | 


Warning: The indexer has encountered a begin page-range without a 
corresponding end page-range. It will treat the begin page-range as a 
single page number reference. 


User Action: Edit the SDML file and add an end page-range. 


CANTFREE, internal error in freeing virtual memory 


Warning: The indexer encountered an internal error in attempting to free 
some virtual memory. 


User Action: Contact Digital. 


CREATED, filespec created 
Success: The indicated output file has been created. 


User Action: None. 


CREATED, filespec created 
Success: The indicated output file has been created. 
User Action: None. 
ENDONLY, end page-range without begin page-range for entry 
string, treating as single entry. 


Warning: The indexer has encountered an end page-range without a 
corresponding begin page-range. It will treat the end page-range as a 
single page number reference. 


User Action: Edit the SDML file and add a begin page-range. 


FILEI, error in reading file 
filespec 


Error: The indexer encountered an error while reading the specified file. 
This message is usually accompanied by a VAX RMS message indicating 
the reason for the failure. 


User Action: Take corrective action based on the associated message. 
FILEO, error in writing file 
filespec 


Error: The indexer encountered an error while writing to the specified 
file. This message is usually accompanied by a VAX RMS message 
indicating the reason for the failure. 


User Action: Take corrective action based on the associated message. 
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FOLIOTOOLONG, warning: folio string too long, ignoring. inx tag is 
string 


Warning: The indexer has attempted to generate a folio string that 
exceeds the length of its internal folio buffer. It will ignore the INX tag 
that caused this. 


User Action: Contact Digital. 
IDENT, _ string 


Informational: Indicates the version of the INDEX utility. This message 
is produced by specifying the [IDENTIFICATION qualifier. 


User Action: None. 


IGNOREDUPREF, ignoring duplicate reference in tag 
string 


Warning: The indexer has encountered a duplicate entry tag on the same 
page and will ignore it. 


User Action: Edit the SDML file and remove the duplicate entry. 


IGNOREINPGRNG, page number references encountered in between page- 
range begin and end for entry 
string, ignoring. 


Warning: The indexer has encountered one or more single page number 
references in between a begin-end page-range sequence. It will ignore 
these in between references. 


User Action: Edit the SDML file and remove references in between the 
begin-end sequence. 


IGNOREINX_LISTLINE, ignoring INX_LIST file line. 
Warning: The above INX_LIST file line will be ignored. 
User Action: Edit the INX_LIST file and correct the erroneous line. 


INX_LIST, error on line string/filespec of string 


Warning: An error was detected in the specified line of the named 
INX_LIST file. 


User Action: Edit the INX_LIST file and correct the erroneous line. 


IN_CLOSE, Error in closing input file filespec 
Warning: 
User Action: 
LANGTRUNC, Warning: tag argument too long.<\ >argument truncated to 
string. 


Warning: The indexer has encountered a <LANGUAGE> tag argument that 
is too long, and is truncating it to the specified string. 


User Action: Edit the SDML file and shorten the <LANGUAGE> tag 
argument. 
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LANG_IGNORED, The <LANGUAGE> tag is not at the beginning of the file and 
will be ignored. 


Warning: The <LANGUAGE> tag was encountered in the INX file after the 
first index entry and will be ignored. 


User Action: Reposition the <LANGUAGE> tag to the start of the INX file. 
LANG_NAME, unsupported language name in tag 
string / string, ignoring, using string 
Warning: The language specified is not supported. 


User Action: Modify the <LANGUAGE> tag in the INX file to specify Danish 
English, Finnish, French, German, Italian, Norwegian, Portuguese, 
Spanish, Swedish, or some other supported language. NCS must have 
support for the specified language. 


MASTERBOTH, warning: master and BOTH on same entry for entry 
string 
using BOTH. 


Warning: The indexer has encountered an entry that contains both a 
MASTER and BOTH entry inclusion attribute. It will convert this entry to 
be a BOTH entry. 


User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 


MASTERNOMASTER, warning: master and NOMASTER on same entry for 
entry 
string 
using master. 


Warning: The indexer has encountered an entry that contains both a 
MASTER and NOMASTER entry inclusion attribute. It will convert this 
entry to be a MASTER entry. 


User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 


NCSCONVERT, error in NCS conversion function. 
Error: An internal NCS error has occurred in the indexer. 


User Action: Contact Digital. 


NCSGETCF, error in getting NCS conversion function id. 
Error: An internal NCS error has occurred in the indexer. 
User Action: Contact Digital. 
NOCLOSEQUOTE, no closing quote. 
Warning: The above INX_LIST file line is missing a closing quote. 
User Action: Edit the INX_LIST file and correct the erroneous line. 
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NOFNAMES, no filenames were found in 
filespec 


Error: The above INX_LIST file contains no filenames. 


User Action: Edit the INX_LIST file and insert one or more filenames. 


NOITEMLIST, index command line information not found on item list 


Error: The indexer could not find the command line information on its 
internal item list. 


User Action: Contact Digital. 


NOMASTERBOTH, warning: NOMASTER and BOTH on same entry for 
entry 


string 
using BOTH. 


Warning: The indexer has encountered an entry that contains both a 
NOMASTER and BOTH entry inclusion attribute. It will convert this 
entry to be a BOTH entry. 


User Action: Edit the SDML file and remove the NOMASTER attribute 
from the entry. 


NOPAGENUMARG, no argument for page number tag, ignoring. 
Warning: A page number tag is missing its argument. 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 


NOTAGARG, tag argument expected after tag 
string, 
but not found. 


Error: A tag in the INX file is missing its argument. 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 


NULFILENAME, no file name found. 


Warning: Each non-comment non-empty line in the INX_LIST file must 
contain a file name. 


User Action: Edit the INX_LIST file and correct the erroneous line. 


OPENIN, could not open filespec for input 
Error: The input file does not exist, or you do not have access to the file. 


User Action: Check the file specification for errors and check to be sure 
that the file is not read protected. 


OPENOUT, could not open filespec for output 


Error: The output file cannot be opened. This message is usually 
accompanied by a VAX RMS message indicating the reason for the failure. 


User Action: Take corrective action based on the associated message. 
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OUT_CLOSE, Error in closing output file filespec 
Warning: None. 


User Action: None. 


READING, reading file filespec 
Informational: The indicated file is being read. 
User Action: None. 
SAMEPGBEGEND, warning: a begin-end page-range on same page for entry 


string 
converting to a single page-number ent ry. 


Warning: The indexer has encountered a begin page-range entry and an 
end page-range entry that fall on the same page. It will convert the begin 
page-range entry to a single page entry and ignore the end page-range 
entry. 


User Action: Edit the SDML file and remove the offending end page- 
range entry. 


TAGARGTOOLONG, indexer tag argument internal buffer limit 
exceeded for tag 
string. 


Warning: This is an indexer internal error. The buffer limit is exceeded 
for reading a tag argument. 


User Action: Edit the SDML file and shorten the lengthy tag argument. 


TAGSTRTOOLONG, indexer tag string internal buffer limit exceeded for tag 
string. 


Error: This is an indexer internal error. The buffer limit is exceeded for 
reading a tag. The INX file may be corrupted. 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 


TOODEEP, maximum subindex depth exceeded 


Warning: An index entry containing ten or more levels of subindexing 
was detected. The subindexing was ignored. 


User Action: Generate index entries with fewer levels of subindexing. 
TOOMANYFNAMES, too many filenames were found in 


filespec 
One or more will be lost. 


Error: The above INX_LIST file contains too many filenames for master 
index generation. The maximum number of INX filenames is 500. 


User Action: Edit the INX_LIST file and reduce the number of filenames 
to 500 or fewer, or split the file and run two separate jobs. 
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Messages 
Index Facility Messages 


UNKNOWNEQSTR, unknown string precedes "=" in tag argument 
attribute list in tag string, 
attempting to continue. 


Warning: The tag argument attribute list in the INX file contains an 
unknown option string preceding the "=". Execution will attempt to 
continue. | 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 


UNKNOWNKWD, unknown keyword in tag arg attribute list in tag 
string,<\ >attempting to continue. 


Warning: The tag argument attribute list in the INX file contains an 
unknown keyword. Execution will attempt to continue. 


User Action: Try reprocessing to get a new INX file. If the problem 
persists, contact Digital. 


USEFILEBOOKNAME, using file name string 
to form book name. 


Warning: The above INX_LIST file line will use the file name as the book 
name. 


User Action: Edit the INX_LIST file and correct the erroneous line. 
VMOVRFLOW, insufficient virtual memory 


Error: The indexer does not have sufficient virtual memory to generate 
the index. 


User Action: Either reduce the size of the index or increase the page file 
quota parameter (PGFLQUO) and reprocess your file. 


WRITING, writing file filespec 
Informational: The indicated file is being written to. 


User Action: None. 
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<ABSTRACT> * 1-2 
description of » 1-2 
related tags 
<FRONT_MATTER> 
<PART_PAGE> 
<TITLE_PAGE> 
<ACCENT> * 1-3 
description of « 1-3 
related tags 
<MCS> 
<PARENDCHAR> 
using acute, grave, or umlaut » 1-3 
Acute accents + 1-3 
Aligning 
numbers in a table « 1-8 
numbers in text, a list, or a table » 1-5 
text in a list > 1-4 . 
text on the right-hand margin of a page « 1-218 
Aligning text on the page * A-6 
<ALIGN_AFTER> * 1-4 
description of * 1-4 
related tags 
<ALIGN_CHAR> 
<ALIGN_NUMBER> 
<LINE>(INDENT) 
<LIST>(STACKED) 
<ALIGN_CHAR> * 1-5 
description of * 1-5 to 1-7 
related tags 
<ALIGN_AFTER> 
<ALIGN_NUMBER> 
<TABLE_ROW> 
<ALIGN_NUMBER> * 1-8 
description of 1-8 to 1-9 
related tags 
<ALIGN_CHAR> 
<ALIGN_NUMBER> 
<TABLE_ROW> 


AMPERSAND 
in math expressions * 1-166 


<AMPERSAND> * 1-10 
description of * 1-10 
related tags 
<BACKSLASH> 
<CPAREN> 
. <OPAREN> 
<VBAR> 
Appendix 
changing default appendix letter ¢ 1-224 
<APPENDIX> * 1—11 
description of * 1—11 to 1-12 
related tags 
<ENDAPPENDIX> 
<SET_APPENDIX.LETTER> 
<ATOP> 
_-in math expressions « 1-166 
Attributes 
of examples * 1-71 
of figures * 1-87 
of tables * 1-242 


<BACKSLASH> * 1-13 
description of * 1-13 
_ in math expressions * 1-166 
related tags 
<AMPERSAND> 
<CPAREN> 
<OPAREN> 
<VBAR> 
BAR_CHAR . 
in math expressions * 1-165 
Batch processing of files » A-4 
/BATCH qualifier * A—4 
Bold type 
in text » 1-60 
of a keyword in text * 1-139 
Bookbuilding 
creating a profile * 1-207 
creating elements * 1-56 
generating an index * 1-133, A-9 
generating a table of contents * 1-34, A-5 
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Index 


<BOX> ¢ 1-14 

description of * 1-14 
Breaking a page * 1-197 

within a monospaced example « 1-282 
Breaks 

in columns, lines, or pages * 1-98 


C 


<CAL> 
in math expressions * 1-166 
Calligraphic letters « 1-166 
<CALLOUT> ° 1-15 
description of » 1-15 
related tags 
<CALLOUTS> 
<CALLOUT_REF> 
<CO> 
<LIST>(CALLOUT) 
Callout numbers 
labelling in an example « 1-15, 1-17, 1-24 
labelling in text * 1-16 
<CALLOUTS> * 1-17 
description of * 1-17 to 1-18 


related tags 





<CALLOUT> 
<CALLOUT_REF> 
<CO> 
<LIST>(CALLOUT) 
<CALLOUT_REF> * 1—16 
description of * 1-16 
related tags 


<CALLOUT> 
<CALLOUTS> 
<CO> 
Capital letters 
small point size * 1~60 
See also <uPPERCASE> 
Captions 
in examples ¢ 1-71 
in figures * 1-87 
in tables + 1-242 


<CASES> 

in math expressions * 1-166 
Caution 

labelling text as » 1-192 
<CDOTS> 


in math expressions * 1-166 
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Centering a heading « 1-22 
<CENTER_LINE> * 1-19 
— description of * 1-19 to 1-20 
related tags 
<LINE> 
<RIGHT_LINE> 
Change bars « 1-215 
<CHAPTER> * 1-21 
description of * 1-21 
related tags 
<REFERENCE> 
<SET_CHAPTER_NUMBER> 
Chapters 
changing the default chapter number « 1-225 | 
<CHEAD> * 1-22 
description of * 1-22 
related tags 
<CENTER_LINE> 
<HEAD> 
<HEADn> 
<SUBHEADn> 
<CHECK_FOR_INCLUSION> * 1-23 
description of » 1-23 
<CHOOSE> . 
in math expressions * 1-166 
<CO> ° 1-24 
description of » 1-24 
related tags 
<CALLOUT> 
<CALLOUTS> 
<CALLOUT_REF> 
<LIST>(CALLOUT) 
<CODE_EXAMPLE> * 1-25 
description of * 1-25 to 1-28 
related tags 
<INTERACTIVE> 
<VALID_BREAK> 
Column breaks * 1-98 
Commands 
coding command/parameter pairs * 1-78, 1-108. 
summary of + A-1 
<COMMENT> * 1-29 
description of * 1-29 to 1-30 
related tag 
<ENDCOMMENT> 
<CONDITION> ¢ 1-31 
description of * 1-31 to 1-33 
related tags 
<ENDCONDITON> 


<CONDITION> 
related tags (cont'd) 


<SET_CONDITION> 
/CONDITION qualifier * A-5 
Conditions 
for files * A-5 
/CONTENTS qualifier « A-5 
<CONTENTS_FILE> * 1-34 
description of * 1-34 to 1-35 
related tags 
<FRONT_MATTER> 
<PROFILE> 
<COPYRIGHT_DATE> * 1-36 
description of « 1-36 
related tags 
<COPYRIGHT_PAGE> 
<FRONT_MATTER> 
<COPYRIGHT_PAGE> * 1-37 
description of * 1-37 
related tags 
<COPYRIGHT_DATE> 
<ENDCOPYRIGHT_PAGE> 
<FRONT_MATTER> 
<PRINT_DATE> 
<CP> * 1-38 
description of * 1-38 
related tag 
<P> 
<CPAREN> * 1—39 
description of * 1-39 


related tags 





<AMPERSAND> 
<BACKSLASH> 
<OPAREN> 
<VBAR> 
<DATE> ° 1-40 ~ 
description of «1-40 to 1-41 


<DDOTS> 
in math expressions * 1-166 
<DEFINE_BOOK_NAME> * 1—42 
description of * 1-42 to 1-43 
related tags 
<DEFINE_SYMBOL> 
<REFERENCE> 


index 


<DEFINE_SYMBOL> * 1—44 
description of « 1-44 to 1-45 
related tags 

<DEFINE_BOOK_NAME> 
<DELAYED> 
<REFERENCE> 

<DEFINITION_LIST> * 1-46 
description of * 1-46 to 1-47 
related tags 

<DEFINITION_LIST_HEAD> 
<DEFLIST_DEF> 
<DEFLIST_ITEM> 
<ENDDEFINITION_LIST> 

<DEFINITION_LIST_HEAD> * 1-48 
description of * 1-48 
related tags 

<DEFINITION_LIST> 
<DEFLIST_DEF> 
<DEFLIST_ITEM> 

<DEFLIST_DEF> * 1—49 
description of * 1-49 
related tags 

<DEFINITION_LIST> 
<DEFINITION_LIST_HEAD> 
<DEFLIST_ITEM> 

<DEFLIST_ITEM> * 1—50 
description of * 1-50 
related tags 

<DEFINITION_LIST> 
<DEFINITION_LIST_HEAD> 
<DEFLIST_DEF> 

Degree character * 1-186 

<DELAYED> * 1-51 
description of * 1-51 to 1-52 
related tags 

<DEFINE_BOOK_NAME> 
<DEFINE_SYMBOL> 
<ENDDELAYED> 

Destination 
See DOCUMENT command, destination 

parameter 

/DEVICE_CONVERTER qualifier * A-6 

Diagnostics 
for LSE * A-8 

/DIAGNOSTICS qualifier » A-8 

Dialog 
between system and user « 1-135 


Index—3 


Index 


<DIVIDED_BY> 
in math expressions * 1-166 
Dividing a document into parts * 1-200, 1-202 
Doctype 
on the command line 


See DOCUMENT command, doctype 


parameter 
<DOCTYPE> ° 1-53 
description of * 1-53 
Document 
partial 
printing * A-7 to A-8 
DOCUMENT command 
for the symbol generator 
parameters * A—17 
parameters * A-2 to A-4 
destination « A-3 
doctype « A-3 
input-file » A~2 
qualifiers » A-4 to A-16 
/BATCH « A-4 
/CONDITION ¢ A-5 
/CONTENTS ¢ A-5 
/DEVICE_CONVERTER « A-6 
/DIAGNOSTICS « A-8 
/ELEMENT ¢ A-8 
/[ANCLUDE * A-8 
/INDEX * A-9 
/KEEP * A—10 
/LIST * A-11 
/LOG « A-11 
/MAP * A-12 
/MASTER_INDEX « A-12 
/OUTPUT * A-12 
/PRINT * A-13 
/PROFILE « A-14 
/SYMBOLS « A~15 
/TAG_TRANSLATOR « A—15 
/TEXT_FORMATTER ¢ A-15 
summary of * A-1 to A-16 
syntax of * A-2 
DOCUMENT symbol generator * A-17 
DOCUMENT symbol! generator command 
parameters 
input-file * A-17 
qualifiers * A—17 
/LIST + A-18 
/PREFIX « A-18 
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Document type 
on the command line 
See DOCUMENT command, doctype 
parameter 
<DOTS> 
in math expressions * 1-166 
dot_char 
in math expressions * 1-165 
<DOT_TIMES> 
in math expressions * 1-166 
<DOUBLE_QUOTE> * 1-54 
description of « 1-54 to 1-55 
related tags 
<PARENDCHAR> 
<QUOTE> 
<SINGLE_QUOTE> 
Duplex printing * A-6 


E 


<ELEMENT> * 1-56 
description of * 1-56 to 1-57 


related tags 





<INCLUDES_FILE> 
<PROFILE> 
/ELEMENT qualifier * A-8 
<ELLIPSis> * 1-58 
description of «1-58 to 1-59 
related tag 
<HELLIPSIS> 
Embedded tables 
breaking across pages * 1-189 
<EMPHASIS> * 1-60 
description of * 1-60 to 1-61 
related tags 
<QUOTE> 
<UNDERLINE> 
Emphasizing 
a keyword in text * 1-139 
a new term in text * 1-191 
a variable in text * 1-285 
<ENDABSTRACT> * 1—2 
<ENDALIGN_CHAR> * 1—5 
<ENDAPPENDIX> * 1—11 
<ENDCALLOUTS> * 1-17 
<ENDCHECK_FOR_INCLUSION> * 1-23 
<ENDCODE_EXAMPLE> * 1—25 


<ENDCOMMENT> * 1—29 
<ENDCONDITION> * 1-31 
<ENDCOPYRIGHT_PAGE> * 1-37, 1-62 
description of * 1-62 
<ENDDEFINITION_LIST> * 1-46 
<ENDDELAYED> * 1-51 
<ENDEXAMPLE> * 1-66 
<ENDFIGURE> * 1-81 
<ENDFORMAT> * 1-108 
<ENDFRONT_MATTER> * 1-114 
<ENDGLOSSARY> * 1-114 
<ENDICON> * 1-124 
<ENDINTERACTIVE> * 1-135 
<ENDLINE_ART> * 1-147 
<ENDLIST> * 1-150 
<ENDLITERAL> * 1-157 
<ENDMARK> * 1-160 
<ENDMATH> * 1-163 
<ENDNOTE> * 1-192 
<ENDPART_PAGE> * 1-63, 1-202 
description of * 1-63 
<ENDPREFACE> * 1-203 
<ENDPROFILE> * 1-207 
<ENDSAMPLE_TEXT> * 1-223 
<ENDTABLE> * 1-240 
<ENDTABLE_KEY> * 1-250 
<ENDTITLE_PAGE> * 1-64, 1-269 
description of * 1-64 
<ENDUNDERLINE> * 1-272 
<ENDUPDATE_RANGE> *° 1-274 
<EQUALIGN> 
in math expressions * 1-166 
<EQUALS> 
in math expressions * 1-166 
Equations in math « 1-163 
Error messages « B-1 
<EXAMPLE> * 1—65 
description of * 1-65 to 1-70 


related tags 
<CODE_EXAMPLE> 


<ENDEXAMPLE> 
<ENDINTERACTIVE> 
<EXAMPLE_ATTRIBUTES> 
<EXAMPLE_FILE> 
<EXAMPLE_SPACE> 
<INTERACTIVE> 
<REFERENCE> 

<S> 

<SAMPLE_TEXT> 


<U> 


Index 


<EXAMPLE>. 
related tags (cont'd) 
<VALID_BREAK> 
Examples 
formal * 1-65 
informal * 1-25 
using callouts in* 1-15, 1-17, 1-24 
<EXAMPLE_ATTRIBUTES> * 1—71 
description of 1-71 to 1-74 
related tags 
<EXAMPLE> 
<EXAMPLE_FILE> 
<EXAMPLE_SPACE> 
<REFERENCE> 
<EXAMPLE_FILE> *° 1-75 
description of « 1-75 
related tags 
<EXAMPLE> 
<EXAMPLE_ATTRIBUTES> 
<EXAMPLE_SPACE> 
<REFERENCE> 
<EXAMPLE_SPACE> * 1—76 
description of * 1-76 to 1-77 
related tags 
<EXAMPLE> 
<EXAMPLE_ATTRIBUTES> 
<EXAMPLE_FILE> 
<REFERENCE> 
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<FCMD> * 1-78 
description of * 1-78 to 1-80 
related tags 
<FORMAT> 
<FPARM> 
<FPARMS> 
<FIGURE> * 1-814 
description of * 1-81 to 1-86 
related tags 
<ENDFIGURE> 
<FIGURE_ATTRIBUTES> 
<FIGURE_FILE> 
<FIGURE_SPACE> 
<ICON> 
<ICON_FILE> 
<LINE_ART> 
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<FIGURE> 
related tags (cont'd) 
<REFERENCE> 
Figures 
captions of * 1-87 
changing the default for vertical blank space 
1-228 
coding multipage figures * 1-87 
coding wide figures * 1-87 
controlling attributes of » 1-87 
controlling formality of * 1-87 
creating * 1-89 
creating line art 
See <LINE_ART> 
keeping a figure with its preceding text « 1-87 
leaving space for * 1-93 
margins in * 1-87 
numbers in the caption * 1-87 
page breaks in * 1-87 
width of » 1-87 
<FIGURE_ATTRIBUTES> * 1—87 
description of * 1-87 to 1-88 
related tags 
<FIGURE> 
<FIGURE_FILE> 
<FIGURE_SPACE> 
<FIGURE_FILE> * 1-89 
description of » 1-91 to 1-92 
related tags 
<FIGURE> 
<FIGURE_ATTRIBUTES> 
<ICON> 
<ICON_FILE> 
<LINE_ART> 
<REFERENCE> 
<SET_FIGURE_FILE_SPACING_DEFAULT> 
<FIGURE_SPACE> * 1-93 
description of * 1-93 to 1-95 
related tags 
<FIGURE> 
<FIGURE_ATTRIBUTES> 
<LINE_ART> 
<REFERENCE> 
Files 
bookbuilding with elements * 1-56 
intermediate 
keeping during processing * A-10 
listing 
producing during processing * A—-11 
producing for the symbol generator * A-18 
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Files (cont'd) 
log 
producing during processing * A—11 
page parameters 
changing * A-6 
printing after processing * A-13 
processing 
assigning new output name « A-12 
processing in batch mode * A—-4 
producing map files during processing * A-12 
setting conditions « 1-31, 1-226, A-5 
File specifications 
in tag arguments * 1-96 
<FILE_SPEC> ° 1-96 
description of + 1-96 to 1-97 
related tags 
<ELEMENT> 
<EXAMPLE_FILE> 
<FIGURE_FILE> 
<ICON_FILE> 
<INCLUDE> 
<INCLUDES_FILE> 
<TABLE_FILE> 
<FINAL_CLEANUP> * 1-98 
description of * 1-99 to 1-100 
related tags 
<COLUMN>, in ARTICLE and REPORT.TWOCOL 
doctypes 
<LINE> 
<PAGE> 
<FOOTNOTE> * 1-101 
description of « 1-101 to 1-103 
related tags 
<FOOTNOTE_TEXT> 
<FOOTREF> 


<FOOTNOTE_TEXT> * 1-104 
description of * 1-104 to 1-105 
related tags 
<FOOTNOTE> 
<FOOTREF> 
<FOOTREF> ° 1-106 
description of * 1-106 to 1-107 
related tags 
<FOOTNOTE> 
<FOOTNOTE_TEXT> 
Formal examples * 1-65 
<FORMAT> * 1-108 
description of «1-108 
related tags 


<FORMAT> 
related tags (cont'd) 
<FCMD> 
<FPARM> 
<FPARMS> 
Formatting 
for special results * 1-98 
<FPARM> * 1-109 
description of * 1-109 
related tags 
<FCMD> 
<FORMAT> 
<FPARMS> 
<FPARMS> * 1-110 
description of * 1-110 
related tags 
<FCMD> 
<FORMAT> 
<FPARM> 
<FRONT_MATTER> © 1-111 
description of * 1-111 to 1-112 
related tags 
<ABSTRACT> 
<CONTENTS_FILE> 
<COPYRIGHT_DATE> 
<COPYRIGHT_PAGE> 
<DEFINE_BOOK_NAME> 
<ENDFRONT_MATTER> 
<ORDER_NUMBER> 
<PREFACE> 
<PREFACE_SECTION> 
<PRINT_DATE> 
<REVISION_INFO> 
<TITLE> 
<TITLE_PAGE> 
<FUNC> 
in math expressions * 1-166 


G 


<GDEF> * 1-113 
description of * 1-113 
related tags 
<GLOSSARY> 
<GREF> 
<TERM> 
Generating symbols * A—17 





index 


<GLOSSARY> * 1-114 
description of * 1-114 to 1-115 
related tags 
<ENDGLOSSARY> 
<GDEF> 
<GTERM> 
Glossary entries 
creating a cross-reference to a term * 1-116 
creating entries anywhere in your document 
1-117 
creating entries in your document 1-113 
Graphics files 
including in SDML files « 1-81, 1-124 
Grave accents * 1-3 
<GREF> * 1-116 
description of * 1-116 
related tags 
<GDEF> 
<GLOSSARY> 
<GTERM> 
<GROUP> 
in math expressions * 1-166 
<GTERM> * 1-117 
description of * 1-117 
related tags 


<GDEF> 
<GLOSSARY> 
<GREF> 
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hat 
in math expressions « 1-165 
hat_char 
in math expressions * 1—165 
<HEAD> * 1-118 
description of « 1-118 
related tags 
<CENTER_LINE> * 1-118 
<CHEAD> * 1-118 
<HEADn> * 1-118 
<SUBHEADn> * 1-118 
Headings 
centered on a line * 1—22 
<HEADn> * 1-119 
description of * 1-119 to 1-121 


related tags 
<CHEAD> 
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<HEADn> - 
related tags (cont'd) 
<HEAD> 
» «<SUBHEADn> 
<HELLIPSIS> * 1-122 
description of * 1-122 
related tag 
<ELLIPSIS> 
<HYPHENATE> * 1-123 
description of * 1-123 
related tags 
<FINAL_CLEANUP>(LINE_BREAK) 
<KEEP> 
<LINE> 
Hyphenation 
for specific line breaks * 1-123 


<ICON> * 1-124 
description of * 1-124 to 1-126 
related tags 
<ENDICON> 
<FIGURE_FILE> 
<ICON_FILE> 
<ICON_TEXT> 
<ICON_FILE> * 1-127 
description of * 1-127 to 1-128 
related tags 
<FIGURE_FILE> 
<ICON> 
<ICON_TEXT> 
<ICON_TEXT> * 1-129 
description of * 1-129 
related tags 
<ICON> 
<ICON_FILE> 
Identification number at the bottom of a copyright 
page * 1-62 
<INCLUDE> * 1—130 
description of * 1-130 
/INCLUDE qualifier > A-8 
<INCLUDES_FILE> * 1-131 
description of * 1-131 to 1-132 
related tags 
<ELEMENT> 
<INCLUDE> 
<PROFILE> 
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Including a file in the current input file » 1-130 
indenting a line * 1-144 
Index 
effect on the index when using a <revision> tag in a 
file » 1-215 
generating * 1-133, A-9 
Indexing ; 
creating main entries * 1-287 
creating “See” and “See also” entries * 1-298 
creating subentries » 1-294, 1-296 
using <xAPPEND> in the <x> tag * 1-287 
using <xsorT> in the <x> tag * 1-288 
using <xsort> in the <y> tag * 1-298 
/INDEX qualifier » A-9 
<INDEX_FILE> * 1-133 
description of * 1-133 to 1-134 
related tags 
<CONTENTS_FILE> 
<PROFILE> 
Informal examples « 1-25 
Informational messages 
sending to a terminal or a log file * 1-278 
Input file. 
See SDML file 
<INTEGRAL> 
in math expressions * 1~167 
<INTEGRAL_LIMITS> 
in math expressions * 1-167 
<INTEGRAL_NOLIMITS> 
in math expressions * 1-167 
<INTERACTIVE> * 1—135 
description of * 1-135 to 1-137 


related tags 
<ENDINTERACTIVE> 


<S> 
<U> 
<VALID_BREAK> 
Intermediate files 
keeping during processing * A-10 
Italicizing 
a keyword in text * 1-139 
_a new term in text * 1-191 
a variable in text * 1-285 
Italics 
in text » 1-60 
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<KEEP> * 1-138 
description of * 1-138 
related tags 

<DEFINE.SYMBOL> 
<EMPHASIS> 
<HYPHENATE> 

/KEEP qualifier * A-10 

<KEYWORD> * 1-139 
description of * 1-139 
related tags 

<NEWTERM> 
<SPECIAL_CHAR> 
<VARIABLE> 
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Labelling parts of your document + 1-200, 1-202 
<LANGUAGE> * 1-140 

description of * 1-140 to 1-142 
<LBAR> 

in math expressions * 1-167 
<LBRACE> 

in math expressions * 1-167 
<LBRACKET> 

in math expressions * 1—167 
<LCEIL> 

in math expressions * 1-167 
<LE> * 1-143 

description of «1-143 

related tag 


<LIST> 
<LFLOOR> 
in math expressions * 1-167 
<LINE> * 1-144 
description of * 1-144 to 1-146 
related tags 
<CENTER_LINE> 
<FINAL_CLEANUP> 
<RIGHT_LINE> 
Line breaks + 1-98 
<LINE_ART> * 1—147 
description of * 1-147 to 1-148 


Index 


<LINE_ART> (cont'd) 
related tags 
<ENDLINE_ART> 
<FIGURE> 
<VALID_BREAK> 
<List> * 1-149 
description of * 1-149 to 1-156 
related tags 
<ALIGN_AFTER> 
<ALIGN_CHAR> 
<ENDLIST> 
<LE> 
Listing file 
producing during processing °A-11 
producing for the symbol generator * A-18 
/LIST qualifier * A-11 
for the symbol generator * A-18 
<LITERAL> * 1-157 
description of > 1-157 to 1-158 
related tag 
<ENDLITERAL> 
Log files 
producing during processing * A—11 
/LOG qualifier + A—11 
<LOWERCASE> * 1-159 
description of * 1-159 
related tag 
<UPPERCASE> 
<LPAREN> 
in math expressions * 1-167 
LSE 
. running diagnostics « A-8 


Map files 
producing during processing * A-12 
/MAP qualifier * A-12 
Margins 
in figures * 1-87 
<MARK> * 1-160 
description of » 1-160 to 1-162 


related tags 





<ENDMARK> 
<REVISION> 
<UPDATE_RANGE> 
Marking text 
using change bars * 1-215 
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/MASTER_INDEX qualifier * A~12 
<MATH> * 1-163 
description of * 1-163 to 1-177 
related tags 
<CODE_EXAMPLE> 
<ENDMATH> 
<MATH_CHAR> 
<REFERENCE> 
tags for math expressions 
<ATOP> 
<BACKSLASH> 
<BAR_CHAR> 
<CAL> 
<CASES> 
<CDOTS> 
<CHOOSE> 
<DDOTS> 
<DIVIDED_BY> 
<DOTS> 
<DOT_CHAR> 
<DOT_TIMES> 
<EQUALIGN> 
<EQUALS> 
<FUNC> 
<GROUP> 
<HAT> 
<HAT_CHAR> 
<INTEGRAL> 
<INTEGRAL_LIMITS> 
<INTEGRAL_NOLIMITS> 
<LBAR> 
<LBRACE> 
<LBRACKET> 
<LCEIL> 
<LFLOOR> 
<LPAREN> 
<MATRIX> 
<MINUS> 
<MOD> 
<OVER> 
<OVERLINE> 
<Pl> 
<PLUS> 
<PMOD> 
<PROD> 
<PROD_LIMITS> 
<PROD_NOLIMITS> 
<RBAR> 
<RBRACE> 
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<MATH> 
tags for math expressions (cont’d) 
<RBRACKET> 
<RCEIL> 
<RFLOOR> 
<RPAREN> 
<SP> 
<SQRT> 
<SUBSCRIPT> 
<SUM> 
<SUM_LIMITS> 
~ <SUM_NOLIMITS> 
<SUPERSCRIPT> 
<TEXT> 
<TILDE> 
<TILDE_CHAR> 
<TIMES> 
<TO> 
<UNDERLINE> 
<VARIABLE> 
<VDOTS> 
<VECTOR> 
<X_TIMES> 
Math expressions 
aligning expressions * 1-172 
delimited expressions « 1-173 
tags for math functions « 1-170 
tags valid in math expressions « 1-166 
using binary operations * 1-164 
using mathematical functions * 1-170 
using matrixes and cases * 1-174 
using operators with and without limits » 1-169 
using parentheses « 1-164 
using variable names « 1-165 
<MATH_CHAR> * 1-178 
description of * 1-178 to 1-185 


related tags 


<MATH> 
<MCS> 
<SPECIAL_CHAR> 
<MATRIX> 
in math expressions * 1-167 
<MCS> * 1-186 
description of * 1-186 to 1-188 
related tags 
<MATH_CHAR> 
<SPECIAL_CHAR> 
Messages 


sending informational messages to terminal or log 
file « 1-278 


Messages (cont'd) 
sending warning messages to terminal or log file + 
1-280 
summary of * B—1 to B—101 
<MINUS> 
in math expressions ¢ 1-167 
<MOD> 
in math expressions * 1-167 
Multinational Character Set * 1-186 


N 


Nested tables 
breaking across pages * 1-189 
<NESTED_TABLE_BREAK> * 1-189 
description of * 1—189 to 1-190 
related tags 
<TABLE> 
<TABLE_FILE> 
Nesting a tag 
in an outer tag’s argument 1-51 
<NEWTERM> * 1-191 
description of * 1-191 
related tags 
<KEYWORD> 
<VARIABLE> 
<NOTE> * 1-192 
description of « 1-192 
related tag 
<ENDNOTE> 
Numbers 
aligning in a table + 1-8 
aligning in text, a list, or a table « 1-5 
in figures * 1-87 


O 


<OPAREN> * 1-193 
description of * 1-193 


related tags 


<AMPERSAND> 
<BACKSLASH> 
<CPAREN> 
<VBAR> 
<ORDER_NUMBER> * 1-194 
description of « 1-194 








Index 


<ORDER_NUMBER> (cont'd) 
related tag 
<TITLE_PAGE> 
Output devices 
See DOCUMENT command, destination 
parameter 
Output file name 
changing * A-12 
/OUTPUT qualifier » A-12 
<OVER> 
in math expressions * 1-167 
OVERLINE 
in math expressions * 1-166 


p 


<P> * 1-195 
description of » 1-195 to 1-196 
related tags 
<CENTER_LINE> 
<CP> 
<LINE> 
<RIGHT_LINE> 
<PAGE> ¢ 1-197 
description of * 1-197 to 1-198 
related tag 
<FINAL_CLEANUP>(PAGE_BREAK) 
Page breaks « 1-197 
for final cleanup * 1-98 
in figures * 1-87 
within monospaced examples « 1-282 
Page parameters 
changing « A-6 
Paragraphs « 1-195 
continuing when interrupted « 1-38 
Parameters 
of the DOCUMENT command for the symbol 
generator * A—17 
Parameters of the DOCUMENT command 
See DOCUMENT command, parameters 
<PARENDCHAR> * 1~199 
description of + 1-199 
Parentheses 
in tag arguments * 1-39, 1-193 
spacing for a character within * 1-199 
using in math « 1-164 
<PART> ° 1—200 
description of * 1-200 to 1-201 
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<PART> (cont’d) 
related tag 
<PART_PAGE> 
Partial document 
printing * A—7 to A-8 
<PART_PAGE> * 1-202 
description of « 1-202 
related tags 
<ABSTRACT> 
<ENDPART_PAGE> 
<PART> 
<RUNNING_TITLE> 
<TITLE> 
<Pl> 
in math expressions * 1-167 
<PLUS> 
in math expressions * 1-167 
<PMOD> 
in math expressions * 1-167 
<PREFACE> * 1—203 
description of * 1-203 to 1-204 
related tags 
<ENDPREFACE> 
<FRONT_MATTER> 
<PREFACE_SECTION> 
<PREFACE_SECTION> ° 1-205 
description of * 1-205 
related tags 
<FRONT_MATTER> 
<PREFACE> 
/PREFIX qualifier « A-18 
Printing 
blank pages * A-6 
duplex pages * A-6 
sections of a document* A-7 to A-8 
Printing files 
double-spacing 
after processing * A-13 
/PRINT qualifier * A-13 
-<PRINT_DATE> * 1-206 
description of « 1-206 
related tags 
<COPYRIGHT_PAGE> 
<FRONT_MATTER> 
Processing files 
assigning a new output name « A-12 
batch mode * A-4 
checking files for inclusion * 1-23 
generating a table of contents « 1-34 
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Processing files (cont’d) 
index » A-9 
indexing ¢ 1-133 
intermediate files 
keeping * A-10 
listing file 
producing * A—11 
producing for the symbol generator * A-18 
log file 
producing * A—11 
map file 
~ producing * A-12 
page parameters 
changing * A-6 
printing 
double-spacing * A-13 
setting conditions * 1-31, 1-226 
setting conditions for * A-5 
table of contents « A—-5 
using elements for bookbuilding « 1-56 
<PROD> 
in math expressions * 1-167 
<PROD_LIMITS> 
in math expressions * 1-168 
<PROD_NOLIMITS> 
in math expressions * 1-168 
Profile 
generating an index * A~9. 
generating an index from * 1-133 
generating a table of contents * A-5 
generating a table of contents from * 1-34 
<PROFILE> * 1-207 
description of * 1-207 to 1-208 
related tags 


<ELEMENT> 
<ENDPROFILE> 
<INCLUDES_FILE> 


/PROFILE qualifier * A—14 





Q 


Qualifiers 
See DOCUMENT command, qualifiers 
See DOCUMENT symbol generator command, 
qualifiers 
<QUOTE> * 1-209 
description of * 1-209 to 1-210 
related tags 
<DOUBLE_QUOTE> 





<QUOTE> 
related tags (cont’d) 


<SINGLE_QUOTE> 





R 


<RBAR> 
in math expressions * 1-168 
<RBRACE> 
in math expressions * 1-168 
<RBRACKET> 
in math expressions * 1-168 
<RCEIL> 
in math expressions * 1-168 
<REFERENCE> * 1~211 
description of * 1-211 to 1-214 
Renumbering after a part page * 1-63 
Revising pages * 1-274 
Revising text 
using change bars * 1-215 
<REVISION> * 1-215 
description of * 1-215 to 1-216 
related tags 
<MARK> 
<UPDATE_RANGE> 
<REVISION_INFO> * 1-217 
description of * 1-217 
related tags 
<FRONT_MATTER> 
<TITLE_PAGE> 
<RFLOOR> 
in math expressions * 1-168 
Right-justified text * 1-218 
<RIGHT_LINE> * 1-218 
description of * 1-218 to 1-219 
related tags 
<CENTER_LINE> 
<LINE> 
<RPAREN> 
in math expressions * 1-168 
<RULE> * 1-220 
description of « 1-220 
related tags 
<SPAN> 
<TABLE> 
<TABLE_HEADS> 
<TABLE_ROW> - 
<TABLE_UNIT_HEADS> 


Index 





S 


<S> * 1-221 
description of * 1-221 to 1-222 
related tags 


<EXAMPLE> 
<INTERACTIVE> 





<U> 
<SAMPLE_TEXT> * 1-223 
description of « 1-223 
related tags 
<CENTER_LINE> 
<ENDSAMPLE_TEXT> 
<P> 
Scientific characters * 1-178 
SDML file 
specifying to DOCUMENT command 
See DOCUMENT command, input-file 
parameter 
specifying to DOCUMENT symbol generator 
command 
See DOCUMENT symbol generator 
command, input-file parameter 
Sections of a document 
printing * A-7 to A-8 
<SET_APPENDIX_LETTER> ¢ 1-224 
description of « 1-224 
related tags 
<APPENDIX> 
<SET_APPENDIX_NUMBER> in the MILSPEC doctype 
<SET_CHAPTER_NUMBER> 
<SET_CHAPTER_NUMBER> * 1-225 
description of * 1-225 
related tags 
<CHAPTER> 
<SET_APPENDIX_LETTER> 
<SET_CONDITION> * 1-226 
description of * 1-226 to 1-227 
related tag 
<CONDITION> 
<SET_FIGURE_FILE_SPACING_DEFAULT> * 1-228 
description of * 1-228 to 1-229 
related tags 
<FIGURE> 
<FIGURE_FILE> 


<SET_TABLE_ROW_BREAK_DEFAULT> * 1-230 
description of * 1-230 to 1-231 
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index 


<SET_TABLE_ROW_BREAK_DEFAULT> (cont'd) 
related tag 
<TABLE_ROW_BREAK> 
<SINGLE_QUOTE> * 1—232 
description of » 1-232 
related tags 
<DOUBLE_QUOTE> 
<PARENDCHAR> 
<QUOTE> 
<SP> 
in math expressions * 1-168 
Spacing within parentheses * 1-199 
<SPAN> * 1-233 
description of * 1-233 to 1-235 
related tags 
<RULE> 
<TABLE_HEADS> 
<TABLE_UNIT_HEADS> 
Special formatting * 1-98 
<SPECIAL_CHAR> * 1-236 
description of * 1~236 to 1-237 
related tags 
<MATH_CHAR> 
<MCS> 
<SQRT> 
in math expressions * 1-168 
<SUBHEADn> * 1-238 
description of * 1-238 
related tags 


<CHEAD> 
<HEADn> 

<SUBSCRIPT> 

in math expressions « 1-168 
<SUM> 

in math expressions * 1-168 
Summary of commands » A—1 
<SUM_LIMITS> 

in math expressions * 1-168 
<SUM_NOLIMITS> 

in math expressions * 1-168 
<SUPERSCRIPT> 

in math expressions « 1-169 
Symbol definitions file » 1-44 
Symbol! definitions file for books » 1-42 
Symbol generator command 

parameters * A-17 
Symbol names 

default output * 1-211 

referring to in other files » 1-44 
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Symbo! names for books 

referring to in other files * 1-42 
Symbols 

generating by the symbol generator * A-17 
/SYMBOLS qualifier * A—15 
Syntax 

See DOCUMENT command, syntax of 
System/user dialog * 1-135 
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<TABLE> * 1-239 
description of * 1-239 to 1-241 


related tags 
<ALIGN_CHAR> 
<ALIGN_NUMBER> 





<ENDTABLE> 
<NESTED_TABLE_BREAK> 
<REFERENCE> 
<RULE> 
<SPAN> 
<TABLE_ATTRIBUTES> 
<TABLE_FILE> 
<TABLE_HEADS> 
<TABLE_KEY> 
<TABLE_KEYREF> 
<TABLE_ROW> 
<TABLE_ROW_BREAK> 
<TABLE_SETUP> 
<TABLE_SPACE> 
<TABLE_UNIT> 
<TABLE_UNIT_HEADS> 
<VALID_TABLE_ROW_BREAK> 
Table of contents 
effect on the table of contents when using a 
<REVISION> tag in a file * 1-215 
generating * 1-34, A-5 
Tables 
attributes of * 1-242 
breaking a table across pages * 1-256 
breaking nested tables across pages + 1~-189 
creating table headings * 1-248 
creating table rows * 1-254 
grouping table rows * 1-263 
headings for table units * 1-265 
including a separate table file in an SDML file » 
1-246 
leaving space for a table in a document + 1-261 


Tables (cont'd) 
outputting a rule following table headings * 1-220 
overriding the default page break * 1-230 
page breaks within table rows * 1-284 
setting up table columns « 1-259 
text exceeding column width * 1-233 
using a table key or legend « 1-250 
<TABLE_ATTRIBUTES> * 1-242 
description of * 1-242 to 1-245 
related tags 
<TABLE> 
<TABLE_SETUP> 
<TABLE_FILE> * 1-246 
description of « 1-246 to 1-247 
related tag 
<TABLE> 
<TABLE_HEADS> * 1-248 
_ description of * 1-248 to 1-249 
related tags 
<RULE> 
<SPAN> 
<TABLE> 
<TABLE_KEY> ° 1-250 
description of « 1-250 to 1-252 
related tags 
<ENDTABLE_KEY> 
<FOOTNOTE> 
<TABLE> 
<TABLE_KEYREF> 
<TABLE_SETUP> 
<TABLE_KEYREF> * 1—253 
description of « 1-253 
related tags 
<TABLE> 
.  <TABLE_KEY> 
<TABLE_ROW> * 1-254 
description of * 1-254 to 1-255 
related tags 
<ALIGN_CHAR> 
<ALIGN_NUMBER> 
<RULE> 
<SPAN> 
<TABLE> ; 
<TABLE_ROW_BREAK> 
<VALID_TABLE_ROW_BREAK> 
<TABLE_ROW, BREAK> * 1-256 
description of * 1-256 to 1-258 - 
related tags 
<NESTED_TABLE_BREAK> 


| Text 


Index 


<TABLE_ROW_BREAK> 
related tags (cont’d) 
<TABLE> 
<TABLE_UNIT> 
<VALID_TABLE_ROW_BREAK> 
<TABLE_SETUP> * 1~259 
description of * 1-259 to 1-260 
related tags 
<TABLE> 
<TABLE_ATTRIBUTES> 
<TABLE_SPACE> * 1~261 
description of «1-261 to 1-262 
related tags 
<TABLE> 
<TABLE_ROW> 
<TABLE_UNIT> * 1-263 
description of * 1-263 to 1-264 
related tags 
<TABLE> 
_<TABLE_ROW_BREAK> 
<TABLE_UNIT_HEADS> 
<TABLE_UNIT_HEADS> * 1-265 
description of » 1-265 to 1-266 
‘related tags 
<RULE> 
<SPAN> 
<TABLE> 
<TABLE_UNIT> 
Tag 
nested in an outer tag’s argument * 1-51 
<TAG> * 1-267 
description of * 1-267 


related tag 


 <LITERAL> 
/TAG_TRANSLATOR qualifier * A-15 


aligning in a list» 1-4 

aligning on the right-hand margin of a page « 
1-218 | 

breaking a page of « 1-197 

centering in margin « 1~19 © 

coding literally « 1-157 

in double quotes * 1-54 

in lowercase * 1-159 

in quotes ¢« 1-209 

in single quotes * 1-232 

in uppercase * 1-277 

keeping on the same line of output » 1-138 

labelling a note, caution, or warning » 1-192 

marking for exclusion * 1-29 
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Text (cont’d) 
placing on a new line » 1-144 
special formatting of + 1-223 
underlining * 1-272 
using callouts in * 1-16 
<TEXT> 
in math expressions * 1-169 
/TEXT_FORMATTER qualifier » A—15 
tilde . 
in math expressions « 1-166 
tilde_char 
in math expressions « 1-166 
<TIMES> 
in math expressions * 1-169 
<TITLE> * 1-268 
description of * 1-268 
related tags 
<PART_PAGE> 
<TITLE_PAGE> 
Title page 
revision information * 1-217 
text at bottom of the page « 1-64 
<TITLE_PAGE> * 1~—269 
description of * 1-269 
related tags 
<ENDTITLE_PAGE> 
<FRONT_MATTER> 
<TO> 
in math expressions * 1-169 
Trademark symbol « 1-236 
in footnotes * 1-104 


U 


<U> * 1-270 
description of * 1-270 to 1-271 
related tags 


<EXAMPLE> 
<INTERACTIVE> 





<S> 
Umlaut accents « 1-3 
UNDERLINE 
in math expressions ¢ 1-166 
<UNDERLINE> * 1-272 
description of * 1-272 to 1-273 
related tag 


<ENDUNDERLINE> 
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<UPDATE_RANGE>° 1-274 |. 
description of » 1-274 td 1-276 
related tags 
<ENDUPDATE_RANGE> 
<MARK> 
_* <REVISION> 
Updating pages « 1-274 
Updating text. 
using change bars » 1-215 
<UPPERCASE> * 1-277 
description of * 1-277 
related tag 
<LOWERCASE> 
<USER_|_MESSAGE> * 1-278 
description of «1-278 to 1-279 
related tag 
<USER_W_MESSAGE> 
<USER_W_MESSAGE> * 1—280 
description of * 1-280 to 1-281 
related tag 
<USER_I_MESSAGE> 





<VALID_BREAK> * 1—282 
description of « 1-282 to 1-283 
related tags 

<CODE_EXAMPLE> 
<DISPLAY> 
<INTERACTIVE> 
<LINE_ART> 

<VALID_TABLE_ROW_BREAK> ¢ 1-284 . 
description of « 1-284 
related tags 

<NESTED_TABLE_BREAK> 
<TABLE> 

<VARIABLE> * 1-285 
description of * 1-285 
in math expressions * 1-169 
related tag 

<KEYWORD> 

VAX DOCUMENT 
See DOCUMENT command 

<VBAR> * 1-286 
description of * 1-286 
related tags 

<AMPERSAND> 





<VBAR> 
related tags (cont’d) 
" <BACKSLASH> 
<CPAREN> 
<OPAREN> 
<VDOTS> 
in math expressions * 1-169 
VECTOR 
in math expressions * 1-166 
<VECTOR> 
in math expressions * 1-169 
Vertical bar 
using in an argument « 1-286 


W 


Warning 

labelling text as * 1-192 
Warning messages 

sending to a terminal or a log file * 1-280 
Width . 

in figures * 1-87 


X 


<X> . 1-287 
description of « 1-287 to 1-293 
related tags 











“<XS> 
<XSUBENTRY> 


<Y> 


Index 


<XS> ° 1-294 
description of * 1-294 to 1-295 


related tags 


<X> 
<XSUBENTRY> 
<Y> 
<XSUBENTRY> * 1-296 
description of * 1-296 to 1-297 


related tags 


<X_TIMES> 
in math expressions * 1-169 


<Y>° 1-298 ; 
description of » 1-298 to 1-299 


related tags 





<X> 
<XS> 
<XSUBENTRY> 
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How to Order Additional Documentation 





Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location Call 


Continental USA, 800-DIGITAL 
Alaska, or Hawaii 


Puerto Rico 809-754-7575 
Canada 800-267-6215 
International 

Internal! 


Contact 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local Digital subsidiary 


Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 


Local Digital subsidiary or 
approved distributor 


USASSB Order Processing - WMO/E15 
or 

U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1¥For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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